1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
|
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
## [3.2.1] - 2026-01-22
### Fixed
- Type hints for `Meta` class fields (`project`, `section`, `assignee`) now correctly indicate that tuple values can be `None`
## [3.2.0] - 2026-01-16
### Added
- Support for searching projects
- Support for searching sections
- Support for searching labels
## [3.1.0] - 2025-05-07
### Added
- Support for moving tasks, courtesy of @radiant-tangent
- Support for `backups:read` scope
- Re-add support for `X-Request-ID`
- Configurable via `request_id_fn` API constructor argument
- Defaults to random UUID v4
- Automatic testing across all supported Python versions
### Fixed
- Compatibility with Python 3.9 and Python 3.10
## [3.0.1] - 2025-04-15
### Fixed
- Wheel and source distributions didn't include the package itself
- Project requiring Python 3.13 to be installed
## [3.0.0] - 2025-04-11
### Added
- Support for deadlines
- Support for archiving and unarchiving projects
- Support for fetching completed tasks by due date range and by completion date range
- Support for `note`, `reminder`, and `auto_reminder` in `add_task_quick`
- Documentation for all SDK functions, arguments, and return objects
- Types, type hints for all SDK functions, arguments, and return objects
- Function to obtain project URLs
### Changed
- Use `dataclass-wizard` for object mapping
- Modernized SDK to use the Todoist API v1
- Remove deprecated `Task.sync_id`, `Task.comment_count`, and `Project.comment_count`
- Replace `Task.is_completed` with `Task.completed_at`
- Add support for `calendar` in `Project.view_style`
- Rename `quick_add_task` to `add_task_quick`
- Add `filter_tasks`, extracting that workflow from `get_tasks`
- Paginate results via an `Iterator` in `get_tasks`, `filter_task`, `get_projects`,
`get_collaborators`, `get_sections`, `get_comments`, `get_labels`, `get_shared_labels`
- Receive `date` and `datetime` arguments as objects, not strings
- Remove support for `X-Request-Id` header, unused on the API level
- "Hide" internal modules and functions
- Task URLs are now obtained on demand, improving performance when not needed
### Fixed
- API requests configure appropriate timeouts to avoid connections hanging
## [2.1.7] - 2024-08-13
### Fixes
- Regression with some `Project` object attributes
## [2.1.6] - 2024-08-07
### Fixes
- `TodoistAPIAsync` accepts a `session` parameter
- State becomes optional in `AuthResult.from_dict()`
- Duration handling in `to_dict()` and tests
- Default value to `section_id`
- Properly close requests `Session` object
## [2.1.5] - 2024-05-22
### Fixes
- Key error on `can_assign_tasks` in `Project` model
## [2.1.4] - 2024-05-07
### Added
- Support `project.can_assign_tasks`
- Add `duration` to `Task` object
- Pagination example
## [2.1.3] - 2023-08-15
### Added
- Support for getting completed items through the items archive
## [2.1.2] - 2023-08-14
### Fixes
- Restore Python 3.9 compatibility
## [2.1.1] - 2023-08-09
### Fixes
- Building environment updates
## [2.1.0] - 2023-08-02
### Changed
- Use built-in data classes instead of `attrs`
## [2.0.2] - 2022-11-02
### Fixes
- Task property `date_added` should be `added_at`
## [2.0.1] - 2022-10-06
### Fixes
- Fixed a crash in `get_comments` if attachment is null.
## [2.0.0] - 2022-09-08
Migrate to [REST API v2](https://developer.todoist.com/rest/v2/?python).
## [1.1.1] - 2022-02-15
### Fixes
- Add missing `attrs` package dependency
### Security
- Dependabot updates
## [1.1.0] - 2021-11-23
### Added
- Public release
|
