Todos

The Todos area gives access to your company's todos.

Required scope: todos

Required license

This area is only available if the Task management add-on is included in your license.

Setting up API access is described in the Help Center.

Endpoints

Method	Endpoint	Description
GET	/api/oauth/v2/resource/todos	Paginated list of all todos
GET	/api/oauth/v2/resource/todos/{uuid}	Details of a single todo
POST	/api/oauth/v2/resource/todos	Create a new todo
PUT	/api/oauth/v2/resource/todos/{uuid}	Update a todo
DELETE	/api/oauth/v2/resource/todos/{uuid}	Delete a todo
GET	/api/oauth/v2/resource/todos/statuses	Get available statuses
GET	/api/oauth/v2/resource/todos/statuses/{uuid}	Get status
POST	/api/oauth/v2/resource/todos/{uuid}/status	Set the status of a todo
GET	/api/oauth/v2/resource/todos/tags	List tags
GET	/api/oauth/v2/resource/todos/tags/{uuid}	Get tag
GET	/api/oauth/v2/resource/todos/{uuid}/references	List a todo's references
GET	/api/oauth/v2/resource/todos/{uuid}/references/{referenceUuid}	Get reference
POST	/api/oauth/v2/resource/todos/{uuid}/references	Create a reference
DELETE	/api/oauth/v2/resource/todos/{uuid}/references/{referenceUuid}	Delete a reference

Note: Todos are not permanently deleted. A deleted todo remains retrievable via GET /todos/{uuid} and via status=deleted or without a status filter in the list.