AstraCMS
Categories

Get a single category

Get a single category by slug or ID, optionally including related posts

GET
/v1/{workspaceId}/categories/{identifier}

Path Parameters

workspaceId*string

Workspace identifier

identifier*string

Category slug or ID

Query Parameters

limit?string

Number of posts per page when including posts

Default"10"
page?string

Page number for pagination when including posts

Default"1"
include?string

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

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.astracms.dev/v1/my-workspace/categories/technology"
{
  "id": "clx2k4m6n8p0r2t4v6x8z",
  "name": "Technology",
  "slug": "technology",
  "description": "Tech articles and news",
  "count": {
    "posts": 42
  }
}
{
  "error": "string",
  "details": null,
  "message": "string"
}
{
  "error": "string",
  "details": null,
  "message": "string"
}
{
  "error": "string",
  "details": null,
  "message": "string"
}

Last updated on