TOtodoist
Templates

Export As Url

Publish a project as a shareable template URL. Requires data:read_write and project export permission.

This stores a publicly accessible CSV artifact. No expiry is set on this URL. Pass it to https://todoist.com/api/v1/import/project_from_url?t_url=<url> to share the template.

On v1.6+, dated tasks also get DATE_TYPE and DATE_TIME columns, and TIMEZONE holds the task's own timezone only for fixed_datetime dues. Older versions write the exporting user's timezone on every row. With use_relative_dates=false, non-recurring dues are ISO 8601 values.

get/api/v1/templates/url

Request

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

Query parameters

project_idstring required

String ID of the project to export as a template URL.

Example:6XGgm6PHrGgMpCFX
use_relative_datesboolean

Whether to export due dates as relative dates.

Example:true

Response

Successful Response

file_namestring required

Name of the exported template file.

file_urlstring uri required

Publicly accessible URL of the stored template CSV. No expiry is set.

Example response

{
  "file_name": "Project.csv",
  "file_url": "https://example.com/Project.csv"
}

Changes

No recorded changes to this operation across all 34 revisions of this API.