POST /tasks/{taskId}
Updates a specified task and returns it as a JSON object.
Servers
- https://api.todoist.com/rest/v2
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
taskId |
String | Yes |
The ID of the task to update. |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
priority |
Integer | No |
Task priority from 1 (normal) to 4 (urgent). |
due_string |
String | No |
Human-defined task due date (ex. "next Monday," "Tomorrow"). Value is set using local (not UTC) time. |
description |
String | No |
A description for the task. This value may contain markdown-formatted text and hyperlinks. |
labels[] |
Array | No |
The task's labels (a list of names that may represent either personal or shared labels). |
assignee_id |
String | No |
The responsible user ID or null to unset (for shared tasks). |
duration_unit |
String | No |
The unit of time for the duration. Must be either 'minute' or 'day'. |
content |
String | No |
Task content. This value may contain markdown-formatted text and hyperlinks. |
due_datetime |
String | No |
Specific date and time in RFC3339 format in UTC. |
due_lang |
String | No |
2-letter code specifying the language in case due_string is not written in English. |
duration |
Integer | No |
A positive integer for the task duration, or null to unset. If specified, you must define a duration_unit. |
due_date |
String | No |
Specific date in YYYY-MM-DD format relative to the user's timezone. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.