| name | todoist-sync-api-reference |
| description | Reference documentation for the Todoist Sync API. Use this skill when building integrations with Todoist, implementing sync functionality, or needing to understand Todoist API endpoints for tasks, projects, labels, filters, reminders, comments, workspaces, and user management. Load the relevant reference file(s) based on the resource type you're working with. |
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 taskitem_update - Update a taskitem_move - Move a taskitem_reorder - Reorder tasksitem_delete - Delete tasksitem_complete - Complete a taskitem_uncomplete - Uncomplete a taskitem_complete_recurring - Complete recurring taskitem_close - Close a taskitem_update_day_orders - Update day orders
Projects
project_add - Add a projectproject_update - Update a projectproject_move - Move a projectproject_delete - Delete a projectproject_archive - Archive a projectproject_unarchive - Unarchive a projectproject_reorder - Reorder projects
Sections
section_add - Add a sectionsection_update - Update a sectionsection_move - Move a sectionsection_reorder - Reorder sectionssection_delete - Delete a sectionsection_archive - Archive a sectionsection_unarchive - Unarchive a section
Labels
label_add - Add a personal labellabel_update - Update a personal labellabel_delete - Delete a personal labellabel_rename - Rename a shared labellabel_delete_occurrences - Delete shared label occurrenceslabel_update_orders - Update label orders
Filters
filter_add - Add a filterfilter_update - Update a filterfilter_delete - Delete a filterfilter_update_orders - Update filter orders
Reminders
reminder_add - Add a reminderreminder_update - Update a reminderreminder_delete - Delete a reminder
Comments
note_add - Add a task commentnote_update - Update a task commentnote_delete - Delete a task commentproject_note_add - Add a project commentproject_note_update - Update a project commentproject_note_delete - Delete a project comment
All Reference Files
