Get a template category

GET/api/v2/template-categories/{pk}/

Retrieve one template category by id. Use it to resolve an id from a project template's category_ids to a name and slug.

The catalog is global, so the path has no workspace. An inactive category returns 404 unless the request includes ?is_active=false, the same filter that List template categories uses.

Path Parameters

pk:requiredstring (uuid)

The id of the template category to retrieve.

Response shaping

fields:optionalstring

Comma-separated list of fields to return. Unrequested keys are omitted from the response, not returned as null, so absent means "not requested" and null means "actually null". id always comes back whether or not you name it.

Pass all for every requestable field. An unknown name is a 400 that lists the valid set and suggests the closest match, so a typo can't silently cost you the saving.

Requestable here: created_at, description, id, is_active, logo_props, name, slug, sort_order, updated_at, updated_by_id.

See Sparse fields.

Scopes

template_categories:read

Errors

Status	Code	Cause
400	invalid_request	?fields= names an unknown field.
401	unauthorized	Missing or invalid credentials.
402	payment_required	Declared on every operation. The catalog has no feature gate, so this endpoint doesn't return it.
403	forbidden	Your token scope can't read template categories.
404	not_found	No category with this id, or the category is inactive and the request has no ?is_active=false.
406	not_acceptable	The Accept header asks for a representation the API can't produce.
429	rate_limited	Throttled. Honor the Retry-After header before retrying.

Get a template category

curl -X GET \
  "https://api.plane.so/api/v2/template-categories/0c6e2a8f-4d1b-4e93-b7a5-9f3c1d8e2b60/" \
  -H "X-Api-Key: $PLANE_API_KEY"

import requests

response = requests.get(
    "https://api.plane.so/api/v2/template-categories/0c6e2a8f-4d1b-4e93-b7a5-9f3c1d8e2b60/",
    headers={"X-Api-Key": "your-api-key"},
)
print(response.json())

const response = await fetch(
  "https://api.plane.so/api/v2/template-categories/0c6e2a8f-4d1b-4e93-b7a5-9f3c1d8e2b60/",
  {
    headers: {
      "X-Api-Key": "your-api-key",
    },
  },
);
const data = await response.json();

Response200

{
  "id": "0c6e2a8f-4d1b-4e93-b7a5-9f3c1d8e2b60",
  "name": "Engineering",
  "slug": "engineering",
  "description": "Templates for software teams",
  "logo_props": {},
  "sort_order": 10000.0,
  "is_active": true,
  "created_at": "2025-11-04T08:15:27.640912Z",
  "updated_at": "2025-11-04T08:15:27.640912Z",
  "updated_by_id": null
}

Response404

{
  "type": "not_found",
  "code": "not_found",
  "detail": "The requested resource was not found."
}