Skip to main content
GET
/
authors
Authors
curl --request GET \
  --url https://api.example.com/authors

​
Endpoints

GET /authors
GET /authors/:id-or-slug
Taxonomy scope:
  • Authors are available only at root (/authors) and apply to articles content.
  • Collection-specific taxonomy endpoints are not supported.

​
List query parameters

ParameterTypeDefaultDescription
pageinteger1Page number
per_pageinteger10Items per page
searchstring-Search by name, slug, or bio
orderbystringnameSort by name, slug, id, date, created_at
orderstringdescasc or desc
_fieldsstring-Comma-separated attribute field filter

​
Example list request

curl "https://api.skayle.ai/v1/ORG_ID/authors?orderby=name&order=asc"

​
Example list response

{
  "data": [
    {
      "id": "author_01HZ...",
      "type": "authors",
      "attributes": {
        "name": "Alex Jordan",
        "slug": "alex-jordan",
        "bio": "SEO lead focused on B2B SaaS growth.",
        "avatar_url": "https://cdn.example.com/avatar.jpg",
        "social_links": {
          "linkedin": "https://www.linkedin.com/in/alex-jordan"
        },
        "auto_assign_description": "Assign for technical SEO and strategy topics.",
        "post_count": 12,
        "created_at": "2025-12-20T07:30:00.000Z",
        "updated_at": "2026-02-01T11:20:00.000Z"
      },
      "relationships": {
        "articles": {
          "data": null,
          "links": {
            "related": "/v1/ORG_ID/articles?authors=author_01HZ..."
          }
        }
      },
      "links": {
        "self": "/v1/ORG_ID/authors/author_01HZ..."
      }
    }
  ],
  "meta": {
    "total": 4,
    "per_page": 10,
    "page": 1
  }
}

​
Example single request

curl "https://api.skayle.ai/v1/ORG_ID/authors/alex-jordan"

​
Single not found

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Author with id or slug \"alex-jordan\" not found"
    }
  ]
}

​
Response field descriptions

FieldTypeDescription
data[].idstringAuthor ID
data[].typestringResource type (authors)
data[].attributes.namestringAuthor display name
data[].attributes.slugstringAuthor slug
data[].attributes.biostring | nullAuthor bio
data[].attributes.avatar_urlstring | nullAvatar image URL
data[].attributes.social_linksobject | nullSocial links
data[].attributes.auto_assign_descriptionstring | nullAuto-assignment guidance text
data[].attributes.post_countnumberPublished article count for this author
data[].attributes.created_atstringISO datetime
data[].attributes.updated_atstringISO datetime
data[].relationships.articlesobjectRelated filtered items feed
meta.totalnumberTotal authors
meta.per_pagenumberPage size
meta.pagenumberCurrent page

​
Filtering and pagination

  • search filters by author name, slug, and bio.
  • page and per_page control pagination.
  • orderby and order control sorting.

​
Error responses

  • 404 when single author ID/slug is not found.