TOtodoist
Templates

Preview Project

Changed on

Preview a project's template graph. Requires data:read and project export permission.

Set resolve_dates=false to preserve raw date strings for a template editor.

get/api/v1/templates/preview

Request

  • Base URL
    https://api.todoist.com
  • URL
    https://api.todoist.com/api/v1/templates/preview
  • Auth
    none declared

Query parameters

project_idstring required

ID of the project to preview as a template.

Example:6XGgm6PHrGgMpCFX
resolve_datesboolean

Resolve date strings to concrete dates. Set to false to preserve raw due, deadline and absolute-reminder date strings when editing a project template.

Example:true

Response

Successful Response

template_type'project' | 'setup' required

Template type: project or setup.

workspace_idstring nullable required

Workspace associated with a saved template, otherwise null.

Example response

{
  "template_type": "project",
  "projects": [
    {
      "id": "6XGgm6PHrGgMpCFX",
      "can_assign_tasks": true,
      "can_comment": true,
      "child_order": 1,
      "order_key": "a0",
      "color": "charcoal",
      "icon": "lightbulb",
      "creator_uid": "1234567",
      "created_at": "2025-01-15T10:30:00Z",
      "name": "Inbox",
      "updated_at": "2025-01-16T10:30:00Z",
      "view_style": "list",
      "default_order": 1,
      "default_order_key": "a1V",
      "description": "Tasks for the launch plan",
      "public_key": "550e8400-e29b-41d4-a716-446655440000",
      "access": {
        "configuration": {
          "hide_collaborator_details": true,
          "disable_duplication": true
        }
      },
      "role": "admin",
      "parent_id": "6XGgm6PHrGgMpCFX"
    }
  ],
  "sections": [
    {
      "id": "6fFPHV272WWh3gpW",
      "user_id": "1234567",
      "project_id": "6XGgm6PHrGgMpCFX",
      "added_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-16T10:30:00Z",
      "archived_at": "2025-01-17T10:30:00Z",
      "name": "Groceries",
      "description": "Tasks for the launch plan",
      "section_order": 1,
      "order_key": "a1V"
    }
  ],
  "items": [
    {
      "user_id": "1234567",
      "id": "6XGgmFVcrG5RRjVr",
      "project_id": "6XGgm6PHrGgMpCFX",
      "section_id": "6fFPHV272WWh3gpW",
      "parent_id": "6XGgmFVcrG5RRjVr",
      "added_by_uid": "1234567",
      "assigned_by_uid": "1234567",
      "responsible_uid": "1234567",
      "labels": [
        "priority"
      ],
      "deadline": {
        "date": "2025-02-12",
        "lang": "en"
      },
      "duration": {
        "amount": 30,
        "unit": "minute"
      },
      "added_at": "2025-01-15T10:30:00Z",
      "completed_at": "2025-01-16T10:30:00Z",
      "completed_by_uid": "1234567",
      "updated_at": "2025-01-17T10:30:00Z",
      "due": {
        "date": "2025-02-12",
        "is_recurring": false,
        "lang": "en",
        "string": "tomorrow"
      },
      "priority": 1,
      "child_order": 1,
      "order_key": "a1V",
      "content": "Buy milk",
      "description": "Pick up organic milk",
      "day_order": 1,
      "completed_count": 3,
      "postponed_count": 1
    }
  ],
  "notes": [
    {
      "id": "6XGgmFQrx44wfGHr",
      "posted_uid": "1234567",
      "content": "Looks good to me.",
      "uids_to_notify": [
        "1234567"
      ],
      "posted_at": "2025-01-15T10:30:00Z",
      "reactions": {
        "👍": [
          "1234567"
        ]
      }
    }
  ],
  "project_notes": [
    {
      "id": "6XGgmFQrx44wfGHr",
      "posted_uid": "1234567",
      "content": "Looks good to me.",
      "uids_to_notify": [
        "1234567"
      ],
      "posted_at": "2025-01-15T10:30:00Z",
      "reactions": {
        "👍": [
          "1234567"
        ]
      }
    }
  ],
  "project_view_options_defaults": [
    {
      "calendar_settings": {
        "color": "PRIORITY",
        "layout": "WEEK",
        "visible_day_count": 3
      }
    }
  ],
  "reminders": [
    {
      "id": "6XGgmFQrx44wfGHr",
      "item_id": "6XGgmFVcrG5RRjVr",
      "notify_uid": "1234567",
      "type": "relative",
      "minute_offset": 30,
      "due": {
        "date": "2025-02-12T09:00:00",
        "lang": "en",
        "timezone": "Europe/Madrid"
      }
    }
  ]
}

Changes