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
{
"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" }
]
}