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

​
Endpoints

GET /tags
GET /tags/:id-or-slug
Taxonomy scope:
  • Tags are available only at root (/tags) 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 or slug
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/tags?search=seo&orderby=name&order=asc"

​
Example list response

{
  "data": [
    {
      "id": "tag_01HZ...",
      "type": "tags",
      "attributes": {
        "name": "SEO",
        "slug": "seo",
        "post_count": 33,
        "created_at": "2025-12-12T10:00:00.000Z",
        "updated_at": "2026-01-22T13:10:00.000Z"
      },
      "relationships": {
        "articles": {
          "data": null,
          "links": {
            "related": "/v1/ORG_ID/articles?tags=tag_01HZ..."
          }
        }
      },
      "links": {
        "self": "/v1/ORG_ID/tags/tag_01HZ..."
      }
    }
  ],
  "meta": {
    "total": 26,
    "per_page": 10,
    "page": 1
  }
}

​
Example single request

curl "https://api.skayle.ai/v1/ORG_ID/tags/seo"

​
Single not found

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Tag with id or slug \"seo\" not found"
    }
  ]
}

​
Response field descriptions

FieldTypeDescription
data[].idstringTag ID
data[].typestringResource type (tags)
data[].attributes.namestringTag name
data[].attributes.slugstringTag slug
data[].attributes.post_countnumberPublished article count for this tag
data[].attributes.created_atstringISO datetime
data[].attributes.updated_atstringISO datetime
data[].relationships.articlesobjectRelated filtered items feed
meta.totalnumberTotal tags
meta.per_pagenumberPage size
meta.pagenumberCurrent page

​
Filtering and pagination

  • search filters by tag name/slug.
  • page and per_page control pagination.
  • orderby and order control sorting.

​
Error responses

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