Document Categories

GET/api/2026-03/categories/{categoryId}

public-api:read

Latest version

ACCESS_TOKEN=ey1234
curl -k -X GET "https://server.livingdocs.io/api/2026-03/categories/{categoryId}" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Path Parameters

Parameter	Type	Description
`categoryId`*	`string`	Id of a specific categories as fetched from the /categories endpoint

Query Parameters

Query String

Passed as URL query string. Comma-separated values for arrays (e.g. ?contentTypes=regular,author).

Parameter	Type	Description
`inheritMetadata`	`boolean`	If set to `true` will inherit (but not overwrite) metadata properties from all parents Inheritance depth is limited to 20

Description

You need to activate the Categories / Routing feature in the Project Config in order to query categories.

Responses

{
  "id": "123abc",
  "label": "Sport",
  "path": "/sport",
  "metadata": {
    "adId": "sport-ads",
    "analyticsCode": "sport-analytics"
  }
}

{
  "status": 400,
  "error": "Bad Request",
  "error_details": {
    "message": "Use of the category API requires a configurable channel. The project you requested uses a static configuration though."
  }
}

{
  "status": 500,
  "error": "Bad Request",
  "error_details": {
    "message": "Inheritance queries can only be made up to a depth of 20."
  }
}

GET/api/2026-03/categories

public-api:read

Latest version (since 2026-01)

ACCESS_TOKEN=ey1234
curl -k -X GET "https://server.livingdocs.io/api/2026-03/categories" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Description

You need to activate the Categories / Routing Feature in the Project Config in order to query categories.

Responses

{
  "results": [
    {
      "id": "category-id-1",
      "label": "Category 1",
      "path": "/category1"
    },
    {
      "id": "category-id-2",
      "label": "Category 2",
      "path": "/category2",
      "parent": "category-id-1"
    },
    {
      "id": "category-id-3",
      "label": "Category 3",
      "path": "/category3"
    }
  ]
}

{
  "status": 400,
  "error": "Bad Request",
  "error_details": {
    "message": "Use of the category API requires a configurable channel. The project you requested uses a static configuration though."
  }
}