Workspace work item templates overview

Workspace work item templates pre-fill new work items across projects.

Other template kinds have their own endpoints: project work item templates, workspace page templates, project page templates, and project templates. The template categories catalog groups templates by subject.

The workspace work item template object

Attributes

• created_at string (date-time)

  When the workspace work item template was created.

• updated_at string (date-time)

  When the workspace work item template was last updated.

• created_by_id string (uuid)

  The user who created the workspace work item template.

• updated_by_id string (uuid) or null

  The user who last updated the workspace work item template. null until someone updates it.

• description_html string

  Rich-text body as HTML. The Plane editor reads and writes this field.

• id string (uuid)

  Unique identifier.

• is_published boolean

  Whether the template is published.

• name string

  Display name.

• short_description string

  A short summary of the template.

• short_id string

  Short identifier for the template.

• slug string

  URL slug for the template.

• template_data object

  The work item seed: the values the template pre-fills on new work items.

• template_type string

  The kind of template.

Response200

{
  "created_at": "2026-01-14T09:22:41.478363Z",
  "created_by_id": "16c61a3a-512a-48ac-b0be-b6b46fe6f430",
  "description_html": "<p>Details go here.</p>",
  "id": "b7e42a19-3c5d-4f80-9a26-8d1c0f4e7b53",
  "is_published": false,
  "name": "Example name",
  "short_description": "example",
  "short_id": "f960d3c2-8524-4a41-b8eb-055ce4be2a7f",
  "slug": "my-team",
  "template_data": {},
  "template_type": "example"
}

Endpoints

Method	Path	Description
GET	/api/v2/workspaces/{slug}/work-item-templates/	List workspace work item templates
GET	/api/v2/workspaces/{slug}/work-item-templates/{pk}/	Get a workspace work item template
POST	/api/v2/workspaces/{slug}/work-item-templates/	Create a workspace work item template
PATCH	/api/v2/workspaces/{slug}/work-item-templates/{pk}/	Update a workspace work item template
DELETE	/api/v2/workspaces/{slug}/work-item-templates/{pk}/	Delete a workspace work item template

Response shaping

Every workspace work item template read accepts ?fields= for sparse responses. See Sparse fields. Errors follow the shared problem+json contract.