Todoist Sync API Reference

Todoist Sync API Reference

Complete reference documentation for the Todoist Sync API v1. The Sync API is designed for efficient data synchronization between clients and Todoist, supporting batching, incremental sync, and temporary resource IDs.

API Endpoint

POST https://api.todoist.com/api/v1/sync

All requests use application/x-www-form-urlencoded format. Responses are JSON.

Authentication

Include the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Quick Reference: When to Load What

Authentication & Authorization

Core Concepts

Resource Types

Collaboration & Sharing

User & Notifications

View Configuration

Data Formats & Limits

Common Operations

Reading Resources

curl https://api.todoist.com/api/v1/sync \
    -H "Authorization: Bearer $TOKEN" \
    -d sync_token='*' \
    -d resource_types='["all"]'

Writing Resources (Commands)

curl https://api.todoist.com/api/v1/sync \
    -H "Authorization: Bearer $TOKEN" \
    -d commands='[{
        "type": "item_add",
        "temp_id": "unique-temp-id",
        "uuid": "unique-command-uuid",
        "args": {"content": "Task name", "project_id": "project-id"}
    }]'

Available Resource Types

labels, projects, items, notes, sections, filters, reminders, reminders_location, locations, user, live_notifications, collaborators, user_settings, notification_settings, user_plan_limits, completed_info, stats, workspaces, workspace_users, workspace_filters, view_options, project_view_options_defaults, role_actions

Use "all" to fetch everything, or prefix with - to exclude (e.g., "-projects").

Command Types by Resource

Tasks

• item_add - Add a task
• item_update - Update a task
• item_move - Move a task
• item_reorder - Reorder tasks
• item_delete - Delete tasks
• item_complete - Complete a task
• item_uncomplete - Uncomplete a task
• item_complete_recurring - Complete recurring task
• item_close - Close a task
• item_update_day_orders - Update day orders

Projects

• project_add - Add a project
• project_update - Update a project
• project_move - Move a project
• project_delete - Delete a project
• project_archive - Archive a project
• project_unarchive - Unarchive a project
• project_reorder - Reorder projects

Sections

• section_add - Add a section
• section_update - Update a section
• section_move - Move a section
• section_reorder - Reorder sections
• section_delete - Delete a section
• section_archive - Archive a section
• section_unarchive - Unarchive a section

Labels

• label_add - Add a personal label
• label_update - Update a personal label
• label_delete - Delete a personal label
• label_rename - Rename a shared label
• label_delete_occurrences - Delete shared label occurrences
• label_update_orders - Update label orders

Filters

• filter_add - Add a filter
• filter_update - Update a filter
• filter_delete - Delete a filter
• filter_update_orders - Update filter orders

Reminders

• reminder_add - Add a reminder
• reminder_update - Update a reminder
• reminder_delete - Delete a reminder

Comments

• note_add - Add a task comment
• note_update - Update a task comment
• note_delete - Delete a task comment
• project_note_add - Add a project comment
• project_note_update - Update a project comment
• project_note_delete - Delete a project comment

All Reference Files

• 00_introduction.md - Introduction to the Sync API
• 01_overview.md - Overview (read/write, batching, incremental sync)
• 02_workspace.md - Workspace operations
• 03_workspace_users.md - Workspace user management
• 04_view_options.md - View options configuration
• 05_project_view_options_defaults.md - Project view defaults
• 06_user.md - User properties, settings, stats
• 07_sharing.md - Sharing and collaborators
• 08_sections.md - Section operations
• 09_reminders.md - Reminder operations
• 10_projects.md - Project operations
• 11_comments.md - Task and project comments
• 12_live_notifications.md - Live notifications
• 13_labels.md - Label operations
• 14_tasks.md - Task (item) operations
• 15_filters.md - Filter operations
• 16_workspace_filters.md - Workspace filter operations
• 17_authorization.md - OAuth, scopes, token exchange, CORS
• 18_colors.md - Color values for projects, labels, filters
• 19_uploads.md - File upload limits
• 20_request_limits.md - Rate limits and payload sizes
• 21_pagination.md - Cursor-based pagination
• 22_due_dates.md - Due date formats and parsing
• 23_deadlines.md - Deadline formats
• 24_quick_add.md - Quick Add API (natural language task creation)