pypi / todoist-api-python
todoist-api-python
What changed in todoist-api-python 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-23.
9 breaking12 new APIs and options1 performance7 behavior and defaults1 tooling2 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli inittodoist-api-python 332 changes
Breaking changes 9
Renames quick_add_task to add_task_quick.
Arguments are now received as date objects, not strings.
Arguments are now received as datetime objects, not strings.
Paginates results via an Iterator in get_tasks.
Removes the deprecated Project.comment_count field in the Todoist API v1 modernization.
Removes the deprecated Task.comment_count field in the Todoist API v1 modernization.
Replaces Task.is_completed with Task.completed_at.
Removes the deprecated Task.sync_id field in the Todoist API v1 modernization.
Removes support for the X-Request-Id header, which is unused on the API level.
New APIs and options 12
Adds support for searching labels.
Adds support for searching projects.
Adds support for searching sections.
Adds support for auto_reminder in add_task_quick.
Adds support for note in add_task_quick.
Adds support for reminder in add_task_quick.
Adds support for fetching completed tasks by due date range and completion date range.
Adds support for deadlines.
Adds filter_tasks, extracting that workflow from get_tasks.
Adds support for archiving and unarchiving projects.
Adds a function to obtain project URLs.
Adds support for calendar in Project.view_style.
Performance 1
Task URLs are obtained on demand, improving performance when not needed.
Behavior and default changes 7
Paginates results via an Iterator in filter_task.
Paginates results via an Iterator in get_collaborators.
Paginates results via an Iterator in get_comments.
Paginates results via an Iterator in get_labels.
Paginates results via an Iterator in get_projects.
Paginates results via an Iterator in get_sections.
Paginates results via an Iterator in get_shared_labels.
Tooling 1
Adds types and type hints for all SDK functions, arguments, and return objects.
Fixes and other changes 2
Type hints for the project, section, and assignee fields now correctly indicate that tuple values can be None.
API requests configure appropriate timeouts to avoid connections hanging.