TOtodoist
Templates

Discover Template

Changed on

Get one template. A UT_ ID requires data:read; invisible or missing IDs return 404.

get/api/v1/templates/{template_id}

Request

  • Base URL
    https://api.todoist.com
  • URL
    https://api.todoist.com/api/v1/templates/{template_id}
  • Auth
    none declared

Path parameters

template_idstring required

A curated template slug or a saved template ID prefixed with UT_.

Example:bug-tracking

Query parameters

localestring

Content locale. Unsupported locales fall back to English.

Example:en

Response

Successful Response

idstring required

Curated template slug or saved template ID (UT_ prefix).

namestring required

Display name.

template_type'setup' | 'project' required

Project template or a complete setup.

short_descriptionstring required

Short template description.

long_descriptionstring required

Full template description.

instructionsstring nullable required

Template instructions, or null.

import_urlstring nullable

Curated template import URL. Omitted for saved templates.

view_type'list' | 'board' | 'calendar' nullable

Project view. Omitted for setup templates and nullable for curated projects.

thumbnail_imagestring nullable required

Thumbnail image for curated templates, or null.

thumbnail_image_darkstring nullable required

Thumbnail image dark for curated templates, or null.

cover_imagestring nullable required

Deprecated alias for thumbnail_image.

preview_imagestring nullable required

Preview image for curated templates, or null.

template_colorstring nullable required

Saved template color name. Null for curated templates.

background_colorstring nullable required

Background color for curated templates, or null.

background_color_darkstring nullable required

Background color dark for curated templates, or null.

category_idsstring[] required

Curated category slugs. Empty for saved templates.

project_countinteger nullable

Number of projects in a curated setup, if known.

label_countinteger nullable

Number of labels in a curated setup, if known.

filter_countinteger nullable

Number of filters in a curated setup, if known.

video_urlstring nullable

Video url for curated templates, or null.

video_preview_image_urlstring nullable

Video preview image url for curated templates, or null.

video_thumbnail_imagestring nullable

Video thumbnail image for curated templates, or null.

workspace_idstring nullable

Associated workspace ID, null for personal templates. Omitted for curated templates.

shared_with_workspace_membersboolean

Whether workspace members may view the saved template. Retained legacy field name.

can_editboolean

Whether the caller may edit this saved template.

last_edited_atstring date-time nullable

Last workspace edit timestamp, or null if unknown or personal.

template_source'todoist' | 'user' required

Curated templates use todoist. Personal and workspace templates use user.

Example response

{
  "id": "bug-tracking",
  "name": "Bug tracking",
  "template_type": "project",
  "short_description": "Track and prioritize bugs.",
  "long_description": "Track issues from report to resolution.",
  "import_url": "https://todoist.com/api/v1/import/project_from_url?t_url=https://example.com/template.csv",
  "view_type": "board",
  "thumbnail_image": "https://example.com/image.png",
  "thumbnail_image_dark": "https://example.com/image.png",
  "cover_image": "https://example.com/image.png",
  "preview_image": "https://example.com/image.png",
  "template_color": "magenta",
  "background_color": "#ffffff",
  "background_color_dark": "#ffffff",
  "creator": {
    "user_id": "123456",
    "name": "Alex Example",
    "avatar": "https://example.com/avatar.png"
  },
  "seo": {
    "title": "Bug tracking",
    "description": "Track and prioritize bugs."
  },
  "more_resources": [
    {
      "title": "Bug tracking",
      "url": "https://todoist.com/templates/bug-tracking"
    }
  ],
  "category_ids": [
    "work"
  ],
  "project_count": 3,
  "label_count": 2,
  "filter_count": 1,
  "video_url": "https://example.com/video.mp4",
  "video_preview_image_url": "https://example.com/image.png",
  "video_thumbnail_image": "https://example.com/image.png",
  "workspace_id": "123456",
  "can_edit": true,
  "last_edited_by": {
    "user_id": "123456",
    "name": "Alex Example",
    "avatar": "https://example.com/avatar.png"
  },
  "last_edited_at": "2026-10-16T10:00:00Z",
  "template_source": "todoist"
}

Changes