# What changed in todoist-api-python

> 32 changes in todoist-api-python 3 from its official release notes, upgrade guides and advisories: 9 breaking, 12 new APIs and options. Each one cited. Sources checked 2026-10-23. HTML: https://unstale.sh/pypi/todoist-api-python/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## todoist-api-python 3

### Breaking changes

- Renames quick_add_task to add_task_quick. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Arguments are now received as date objects, not strings. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Arguments are now received as datetime objects, not strings. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Paginates results via an Iterator in get_tasks. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Removes the deprecated Project.comment_count field in the Todoist API v1 modernization. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Removes the deprecated Task.comment_count field in the Todoist API v1 modernization. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Replaces Task.is_completed with Task.completed_at. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Removes the deprecated Task.sync_id field in the Todoist API v1 modernization. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Removes support for the X-Request-Id header, which is unused on the API level. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)

### New APIs and options

- Adds support for searching labels. (3.2.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/ddad4767413c7f543e54f3bb1d476ce09aa7e915/CHANGELOG.md#320---2026-01-16)
- Adds support for searching projects. (3.2.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/ddad4767413c7f543e54f3bb1d476ce09aa7e915/CHANGELOG.md#320---2026-01-16)
- Adds support for searching sections. (3.2.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/ddad4767413c7f543e54f3bb1d476ce09aa7e915/CHANGELOG.md#320---2026-01-16)
- Adds support for auto_reminder in add_task_quick. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Adds support for note in add_task_quick. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Adds support for reminder in add_task_quick. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Adds support for fetching completed tasks by due date range and completion date range. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Adds support for deadlines. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Adds filter_tasks, extracting that workflow from get_tasks. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Adds support for archiving and unarchiving projects. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Adds a function to obtain project URLs. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Adds support for calendar in Project.view_style. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)

### Performance

- Task URLs are obtained on demand, improving performance when not needed. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)

### Behavior and default changes

- Paginates results via an Iterator in filter_task. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Paginates results via an Iterator in get_collaborators. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Paginates results via an Iterator in get_comments. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Paginates results via an Iterator in get_labels. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Paginates results via an Iterator in get_projects. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Paginates results via an Iterator in get_sections. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)
- Paginates results via an Iterator in get_shared_labels. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)

### Tooling

- Adds types and type hints for all SDK functions, arguments, and return objects. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)

### Fixes and other changes

- Type hints for the project, section, and assignee fields now correctly indicate that tuple values can be None. (3.2.1) — [release notes](https://github.com/Doist/todoist-api-python/blob/ddad4767413c7f543e54f3bb1d476ce09aa7e915/CHANGELOG.md#321---2026-01-22)
- API requests configure appropriate timeouts to avoid connections hanging. (3.0.0) — [release notes](https://github.com/Doist/todoist-api-python/blob/HEAD/CHANGELOG.md)