Todoist · JSON Structure

Todoist Task Structure

Todoist task (item) structure

Type: Properties: 0
ProductivityTasksTo-DoTask ManagementCollaboration

Task is a JSON Structure definition published by Todoist.

Meta-schema:

JSON Structure

Raw ↑
{
  "name": "Task",
  "description": "Todoist task (item) structure",
  "properties": [
    { "name": "id", "type": "string", "required": true, "description": "Unique task ID" },
    { "name": "content", "type": "string", "required": true, "description": "Task title" },
    { "name": "description", "type": "string", "required": false, "description": "Extended description" },
    { "name": "project_id", "type": "string", "required": false, "description": "Parent project ID" },
    { "name": "section_id", "type": "string", "required": false, "description": "Parent section ID" },
    { "name": "parent_id", "type": "string", "required": false, "description": "Parent task ID for subtasks" },
    { "name": "order", "type": "integer", "required": false, "description": "Sort order" },
    { "name": "labels", "type": "array<string>", "required": false, "description": "Applied label names" },
    { "name": "priority", "type": "integer", "required": false, "description": "1-4 priority level" },
    { "name": "due", "type": "object", "required": false, "description": "Due date details",
      "properties": [
        { "name": "date", "type": "string", "description": "YYYY-MM-DD" },
        { "name": "is_recurring", "type": "boolean" },
        { "name": "string", "type": "string", "description": "Natural language due string" },
        { "name": "datetime", "type": "string", "description": "ISO datetime" },
        { "name": "timezone", "type": "string" }
      ]
    },
    { "name": "assignee_id", "type": "string", "required": false },
    { "name": "comment_count", "type": "integer", "required": false },
    { "name": "is_completed", "type": "boolean", "required": true },
    { "name": "created_at", "type": "string", "required": false, "description": "ISO 8601 creation timestamp" },
    { "name": "creator_id", "type": "string", "required": false },
    { "name": "url", "type": "string", "required": false, "description": "Deep link URL" }
  ]
}