AstraCMS
Authors

List authors

Get a paginated list of authors with post counts

GET
/v1/{workspaceId}/authors

Path Parameters

workspaceId*string

Workspace identifier

Query Parameters

limit?string

Number of authors per page

Default"10"
page?string

Page number for pagination

Default"1"
include?string

Related resources to include (e.g., posts)

Response Body

application/json

application/json

application/json

curl -X GET "https://api.astracms.dev/v1/my-workspace/authors"
{
  "authors": [
    {
      "id": "clx1a2b3c4d5e6f7g8h9i",
      "name": "John Doe",
      "image": "https://example.com/avatar.jpg",
      "slug": "john-doe",
      "bio": "Tech writer and developer",
      "role": "Senior Developer",
      "socials": [
        {
          "url": "https://twitter.com/johndoe",
          "platform": "twitter"
        }
      ],
      "count": {
        "posts": 25
      }
    }
  ],
  "pagination": {
    "limit": 10,
    "currentPage": 1,
    "nextPage": 2,
    "previousPage": null,
    "totalPages": 5,
    "totalItems": 48
  }
}
{
  "error": "string",
  "details": null,
  "message": "string"
}
{
  "error": "string",
  "details": null,
  "message": "string"
}

Last updated on