Project work item templates overview

Project work item templates pre-fill new work items in one project.

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

The project work item template object

Attributes

• created_at string (date-time)

  When the project work item template was created.

• updated_at string (date-time)

  When the project work item template was last updated.

• created_by_id string (uuid)

  The user who created the project work item template.

• updated_by_id string (uuid) or null

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

• description_html string

  Rich-text body as HTML. This is the field the Plane editor round-trips.

• id string (uuid)

  Unique identifier.

• is_published boolean

  Whether the template is published.

• name string

  Display name.

• short_description string

  The short description.

• short_id string

  The related short.

• slug string

  The slug.

• template_data object

  The template data.

• template_type string

  The template type.

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}/projects/{project_id}/work-item-templates/	List project work item templates
GET	/api/v2/workspaces/{slug}/projects/{project_id}/work-item-templates/{pk}/	Get a project work item template
POST	/api/v2/workspaces/{slug}/projects/{project_id}/work-item-templates/	Create a project work item template
PATCH	/api/v2/workspaces/{slug}/projects/{project_id}/work-item-templates/{pk}/	Update a project work item template
DELETE	/api/v2/workspaces/{slug}/projects/{project_id}/work-item-templates/{pk}/	Delete a project work item template
POST	/api/v2/workspaces/{slug}/projects/{project_id}/work-item-templates/{pk}/use/	Create a work item from a template

Response shaping

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