• Installs:
  • Today: 49
  • All Time: 9674
Developer:userdimas

Todoist API Package

Do more to customize the experience, organize your tasks and projects, and optimize your productivity.

List of Endpoints
This is the list of endpoints this API includes. To add any of the endpoints to your app, please click on “Connect to endpoint” text.
See All
List of Webhook Events
This is the list of webhook events this API provides. Webhooks allow you to register to certain events and receive real-time data over websockets.
See All
Discussions
See All
Readme

Todoist

Todoist Package

Todoist offers more useful features than any other to do service. So you can do more to customize the experience, organize your tasks and projects, and optimize your productivity.

  • Domain: todoist.com
  • Credentials: clientId, clientSecret

How to get credentials:

  1. Register on the todoist.com.
  2. Create your Todoist Application in console.
  3. After creation app, you will receive clientId / clientSecret.

Custom datatypes:

DatatypeDescriptionExample
DatepickerString which includes date and time2016-05-28 00:00:00
MapString which includes latitude and longitude coma separated50.37, 26.56
ListSimple array["123", "sample"]
SelectString with predefined valuessample
ArrayArray of objects[{"Second name":"123","Age":"12","Photo":"sdf","Draft":"sdfsdf"},{"name":"adi","Second name":"bla","Age":"4","Photo":"asfserwe","Draft":"sdfsdf"}]

Todoist.getAccessToken

Exchanging authorization codes for access token.

FieldTypeDescription
clientIdcredentialsThe unique Client ID of the Todoist application that you registered.
clientSecretcredentialsThe unique Client Secret of the Todoist application that you registered.
codeStringThe unique string code that you obtained in the authorization request.
redirectUriStringThe URL to which to send the response to this request.

Todoist.revokeAccessToken

Access tokens obtained via OAuth could be revoke.

FieldTypeDescription
clientIdcredentialsThe unique Client ID of the Todoist application that you registered.
clientSecretcredentialsThe unique Client Secret of the Todoist application that you registered.
accessTokenStringAccess token obtained from the OAuth authentication.

Todoist.exchangeApiToken

Tokens obtained via the old email/password authentication method could be migrated to the new OAuth access token.

FieldTypeDescription
clientIdcredentialsThe unique Client ID of the Todoist application that you registered.
clientSecretcredentialsThe unique Client Secret of the Todoist application that you registered.
apiTokenStringToken obtained from the email/password authentication.
scopeListScopes of the OAuth token. Please refer to the OAuth section for the detailed list of available scopes.Select options - task:add, data:read, data:read_write, data:delete, project:delete.

Todoist.crossOriginResourceSharing

All API endpoints not related to the 3 OAuth steps support Cross Origin Resource Sharing (CORS) for requests from any origin.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
originStringCross Origin Resource Sharing (CORS)

Todoist.readResources

Tokens obtained via the old email/password authentication method could be migrated to the new OAuth access token.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
syncTokenStringA special string, used to allow the client to perform incremental sync. Pass * to retrieve all active resource data.
resourceTypesListUsed to specify what resources to fetch from the server.Select options - "labels", "projects", "items", "notes", "filters", "reminders", "locations", "user", "live_notifications", "collaborators", "notification_settings", "all".

Todoist.createProject

Create project.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.tempIdStringThe temporary resource ID feature allows you to run two or more dependent commands in a single HTTP request. For commands that are related to creation of resources (i.e. createItem, createProject), you can specify an extra tempId as a placeholder for the actual ID of the resource. The other commands in the same sequence could directly refer to tempId if needed.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.nameStringThe name of the project (a string value).
commands.colorNumberThe color of the project (a number between 0 and 11, or between 0 and 21 for premium users).
commands.indentNumberThe indent of the item (a number between 1 and 4, where 1 is top-level).
commands.itemOrderNumberProject’s order in the project list (a number, where the smallest value should place the project at the top).

Todoist.updateProject

Update an existing project.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.tempIdStringThe temporary resource ID feature allows you to run two or more dependent commands in a single HTTP request. For commands that are related to creation of resources (i.e. createItem, createProject), you can specify an extra tempId as a placeholder for the actual ID of the resource. The other commands in the same sequence could directly refer to tempId if needed.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.nameStringThe name of the project (a string value).
commands.colorNumberThe color of the project (a number between 0 and 11, or between 0 and 21 for premium users).
commands.indentNumberThe indent of the item (a number between 1 and 4, where 1 is top-level).
commands.itemOrderNumberProject’s order in the project list (a number, where the smallest value should place the project at the top).
commands.collapsedSelectWhether the project’s sub-projects are collapsed (where 1 is true and 0 is false).Options - true,false.

Todoist.deleteProject

Delete an existing project.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
idsListList of the ids of the projects to delete (could be temp ids).
uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.

Todoist.archiveProject

Archive project and its children.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
idsListList of the ids of the projects to delete (could be temp ids).
uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.

Todoist.unarchiveProject

Unarchive project and its children.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
idsListList of the ids of the projects to delete (could be temp ids).
uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.

Todoist.updateMultipleOrdersAndIndents

Update the orders and indents of multiple projects at once.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
idsToOrdersIndentsArrayA dictionary array, with a project id as key and a two elements list as value: project_id: item_order, indent.

Todoist.createItem

Add a new task to a project.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.tempIdStringThe temporary resource ID feature allows you to run two or more dependent commands in a single HTTP request. For commands that are related to creation of resources (i.e. createItem, createProject), you can specify an extra tempId as a placeholder for the actual ID of the resource. The other commands in the same sequence could directly refer to tempId if needed.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.contentStringThe text of the task.
commands.projectIdStringThe id of the project to add the task to (a number or a temp id). By default the task is added to the user’s Inbox project.
commands.dateStringStringThe date of the task, added in free form text, for example it can be every day @ 10 (or null or an empty string to unset). Look at our reference to see which formats are supported.
commands.dateLangSelectThe language of the dateString. Options - en, da, pl, zh, ko, de, pt, ja, it, fr, sv, ru, es, nl.
commands.dueDateUtcDatePickerNote that, when the dueDateUtc argument is specified, the date_string is required and has to specified as well, and also, the date_string argument will be parsed as local timestamp, and converted to UTC internally, according to the user’s profile settings.
commands.prioritySelectThe priority of the task (a number between 1 and 4, 4 for very urgent and 1 for natural). Keep in mind that very urgent is the priority 1 on clients. So, p1 will return 4 in the API.
commands.indentNumberThe indent of the task (a number between 1 and 4, where 1 is top-level).
commands.itemOrderNumberThe order of the task inside a project (a number, where the smallest value would place the task at the top).
commands.dayOrderNumberThe order of the task inside the Today or Next 7 days view (a number, where the smallest value would place the task at the top).
commands.collapsedSelectWhether the task’s sub-tasks are collapsed (where 1 is true and 0 is false).Options - true,false.
commands.labelsJSONThe tasks labels (a list of label ids such as [2324,2525]).
commands.assignedByUidNumberThe id of user who assigns the current task. This makes sense for shared projects only. Accepts 0 or any user id from the list of project collaborators. If this value is unset or invalid, it will be automatically setup to your uid.
commands.responsibleUidNumberThe id of user who is responsible for accomplishing the current task. This makes sense for shared projects only. Accepts any user id from the list of project collaborators or null or an empty string to unset.
commands.autoReminderSelectWhen this option is enabled, the default reminder will be added to the new item if it has a due date with time set.

Todoist.updateItem

Updates an item for the user related to the API credentials.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.tempIdStringThe temporary resource ID feature allows you to run two or more dependent commands in a single HTTP request. For commands that are related to creation of resources (i.e. createItem, createProject), you can specify an extra tempId as a placeholder for the actual ID of the resource. The other commands in the same sequence could directly refer to tempId if needed.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.idStringThe id of the task.
commands.contentStringThe text of the task.
commands.projectIdStringThe id of the project to add the task to (a number or a temp id). By default the task is added to the user’s Inbox project.
commands.dateStringStringThe date of the task, added in free form text, for example it can be every day @ 10 (or null or an empty string to unset). Look at our reference to see which formats are supported.
commands.dateLangSelectThe language of the dateString. Options - en, da, pl, zh, ko, de, pt, ja, it, fr, sv, ru, es, nl.
commands.dueDateUtcDatePickerNote that, when the dueDateUtc argument is specified, the date_string is required and has to specified as well, and also, the date_string argument will be parsed as local timestamp, and converted to UTC internally, according to the user’s profile settings.
commands.prioritySelectThe priority of the task (a number between 1 and 4, 4 for very urgent and 1 for natural). Keep in mind that very urgent is the priority 1 on clients. So, p1 will return 4 in the API.
commands.indentNumberThe indent of the task (a number between 1 and 4, where 1 is top-level).
commands.itemOrderNumberThe order of the task inside a project (a number, where the smallest value would place the task at the top).
commands.dayOrderNumberThe order of the task inside the Today or Next 7 days view (a number, where the smallest value would place the task at the top).
commands.collapsedSelectWhether the task’s sub-tasks are collapsed (where 1 is true and 0 is false).Options - true,false.
commands.labelsJSONThe tasks labels (a list of label ids such as [2324,2525]).commands.assignedByUidNumberThe id of user who assigns the current task. This makes sense for shared projects only. Accepts 0 or any user id from the list of project collaborators. If this value is unset or invalid, it will be automatically setup to your uid.
commands.responsibleUidNumberThe id of user who is responsible for accomplishing the current task. This makes sense for shared projects only. Accepts any user id from the list of project collaborators or null or an empty string to unset.

Todoist.deleteItem

Delete an existing task.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
itemIdsListList of the ids of the projects to delete (could be temp ids).

Todoist.moveItem

Move a task from one project to another project.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.projectItemsJSONA JSON mapping telling Todoist where the items are currently found. From project ids to item ids, for example {"1523":["9637423"]}, where 1523 is the project id and 9637423 is the item id.
commands.toProjectNumberThe project id that the tasks should be moved to, for example 1245.

Todoist.completeItems

Complete tasks and optionally move them to history. See also itemClose for a simplified version of the command.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
itemIdsListA list of ids to complete (numbers or temp ids).
forceHistorySelectWhether these tasks should be moved to history (where 1 is true and 0 is false, and the default is 1) This is useful when checking off sub tasks.Options - true,false.

Todoist.uncompleteItems

Uncomplete tasks and move them to the active projects.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
itemIdsListA list of items to uncomplete.
restoreStateJSONA dictionary object, where the item id is the key, and its value is a list of four elements, whether the item is in history, whether it is checked, its order and indent - item_id: [in_history, checked, item_order, indent].

Todoist.completeRecurringTask

Complete a recurring task, and the reason why this is a special case is because we need to mark a recurring completion (and using itemUpdate won’t do this). See also item_close for a simplified version of the command.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.idStringThe id of the item to update (a number or a temp id).
commands.newDateUtcDatePickerNote that, when the newDateUtc argument is specified, the date_string is required and has to specified as well, and also, the date_string argument will be parsed as local timestamp, and converted to UTC internally, according to the user’s profile settings.
commands.dateStringStringThe date of the task, added in free form text, for example it can be every day @ 10 (or null or an empty string to unset). Look at our reference to see which formats are supported.
commands.isForwardSelectWhether the task is to be completed (true) or uncompleted (false), while the default is true.Options - true,false.

Todoist.closeItem

A simplified version of itemComplete . The command does exactly what official clients do when you close a task: regular task is completed and moved to history, subtask is checked (marked as done, but not moved to history), recurring task is moved forward (due date is updated).

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.idStringThe id of the item to close (a number or a temp id).

Todoist.updateDayOrders

Update the day orders of multiple items at once.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.dayOrderNumberThe order of the task inside the Today or Next 7 days view (a number, where the smallest value would place the task at the top).
commands.itemIdStringThe item which the note is part of (a unique number or temp id).

Todoist.createLabel

Create a label.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.tempIdStringThe temporary resource ID feature allows you to run two or more dependent commands in a single HTTP request. For commands that are related to creation of resources (i.e. createItem, createProject), you can specify an extra tempId as a placeholder for the actual ID of the resource. The other commands in the same sequence could directly refer to tempId if needed.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.nameStringThe name of the label.
commands.colorNumberThe color of the label (a number between 0 and 7, or between 0 and 12 for premium users).
commands.itemOrderNumberLabel’s order in the label list (a number, where the smallest value should place the label at the top).

Todoist.updateLabel

Update a label.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.tempIdStringThe temporary resource ID feature allows you to run two or more dependent commands in a single HTTP request. For commands that are related to creation of resources (i.e. createItem, createProject), you can specify an extra tempId as a placeholder for the actual ID of the resource. The other commands in the same sequence could directly refer to tempId if needed.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.nameStringThe name of the label.
commands.colorNumberThe color of the label (a number between 0 and 7, or between 0 and 12 for premium users).
commands.itemOrderNumberLabel’s order in the label list (a number, where the smallest value should place the label at the top).

Todoist.deleteLabel

Update a label.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.idStringThe id of the label.

Todoist.updateMultipleOrders

A dictionary, where a label id is the key, and the order its value: labelId : order.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
idOrderMappingArrayA dictionary, where a label id is the key, and the order its value: label_id: order.

Todoist.createNote

Add a note.Is only available for Todoist Premium.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.tempIdStringThe temporary resource ID feature allows you to run two or more dependent commands in a single HTTP request. For commands that are related to creation of resources (i.e. createItem, createProject), you can specify an extra tempId as a placeholder for the actual ID of the resource. The other commands in the same sequence could directly refer to tempId if needed.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.itemIdStringThe item which the note is part of (a unique number or temp id).
commands.contentStringThe content of the note (a string value).
commands.fileAttachmentJSONA file attached to the note (see more details about attachments above, and learn how to upload a file in the Uploads section).
commands.uidsToNotifyJSONA list of user ids to notify.

Todoist.createProjectNote

Add a project note.Is only available for Todoist Premium.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.tempIdStringThe temporary resource ID feature allows you to run two or more dependent commands in a single HTTP request. For commands that are related to creation of resources (i.e. createItem, createProject), you can specify an extra tempId as a placeholder for the actual ID of the resource. The other commands in the same sequence could directly refer to tempId if needed.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.projectIdStringThe project which the note is part of (a unique number or temp id).
commands.contentStringThe content of the note (a string value).
commands.fileAttachmentJSONA file attached to the note (see more details about attachments above, and learn how to upload a file in the Uploads section).

Todoist.updateNote

Update a note.Is only available for Todoist Premium.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.idStringThe id of the note.
commands.contentStringThe content of the note (a string value).
commands.fileAttachmentJSONA file attached to the note (see more details about attachments above, and learn how to upload a file in the Uploads section).

Todoist.deleteNote

Delete a note.Is only available for Todoist Premium.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.idStringThe id of the note.

Todoist.createFilter

Add a filter.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.tempIdStringThe temporary resource ID feature allows you to run two or more dependent commands in a single HTTP request. For commands that are related to creation of resources (i.e. createItem, createProject), you can specify an extra tempId as a placeholder for the actual ID of the resource. The other commands in the same sequence could directly refer to tempId if needed.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.nameStringThe name of the filter.
commands.queryStringThe query to search for. Examples of searches can be found in the Todoist help page.
commands.colorNumberThe color of the project (a number between 0 and 11, or between 0 and 21 for premium users).
commands.itemOrderNumberFilters order in the filter list (a number, where the smallest value should place the project at the top).

Todoist.updateFilter

Update a filter.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.idStringThe id of the filter.
commands.nameStringThe name of the filter.
commands.queryStringThe query to search for. Examples of searches can be found in the Todoist help page.
commands.colorNumberThe color of the project (a number between 0 and 11, or between 0 and 21 for premium users).
commands.itemOrderNumberFilters order in the filter list (a number, where the smallest value should place the project at the top).

Todoist.deleteFilter

Delete a filter.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.idStringThe id of the filter.

Todoist.createReminder

Add a new reminder to the user account related to the API credentials.Is only available for Todoist Premium.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.tempIdStringThe temporary resource ID feature allows you to run two or more dependent commands in a single HTTP request. For commands that are related to creation of resources (i.e. createItem, createProject), you can specify an extra tempId as a placeholder for the actual ID of the resource. The other commands in the same sequence could directly refer to tempId if needed.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.itemIdStringThe item id for which the reminder is about.
commands.typeSelectThe type of the reminder: relative for a time-based reminder specified in minutes from now, absolute for a time-based reminder with a specific time and date in the future, and location for a location-based reminder.
commands.notifyUidNumberThe user id which should be notified of the reminder, typically the current user id creating the reminder.
commands.serviceSelectThe way to get notified of the reminder: email for e-mail, mobile for mobile text message, or push for mobile push notification.
commands.dateStringStringThe date of the task, added in free form text, for example it can be every day @ 10 (or null or an empty string to unset). Look at our reference to see which formats are supported.
commands.dateLangSelectThe language of the dateString. Options - en, da, pl, zh, ko, de, pt, ja, it, fr, sv, ru, es, nl.
commands.dueDateUtcDatePickerNote that, when the dueDateUtc argument is specified, the date_string is required and has to specified as well, and also, the date_string argument will be parsed as local timestamp, and converted to UTC internally, according to the user’s profile settings.
commands.minuteOffsetNumberThe relative time in minutes before the due date of the item, in which the reminder should be triggered. Note, that the item should have a due date set in order to add a relative reminder.
commands.nameStringAn alias name for the location.
commands.coordinatesMapLocation longitude and location latitude.
commands.locTriggerStringWhat should trigger the reminder: on_enter for entering the location, or on_leave for leaving the location.
commands.radiusNumberThe radius around the location that is still considered as part of the location (in meters).

Todoist.updateReminder

Update a reminder from the user account related to the API credentials.Is only available for Todoist Premium.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.idStringThe id of the reminder.
commands.typeSelectThe type of the reminder: relative for a time-based reminder specified in minutes from now, absolute for a time-based reminder with a specific time and date in the future, and location for a location-based reminder.
commands.notifyUidNumberThe user id which should be notified of the reminder, typically the current user id creating the reminder.
commands.serviceSelectThe way to get notified of the reminder: email for e-mail, mobile for mobile text message, or push for mobile push notification.
commands.dateStringStringThe date of the task, added in free form text, for example it can be every day @ 10 (or null or an empty string to unset). Look at our reference to see which formats are supported.
commands.dateLangSelectThe language of the dateString. Options - en, da, pl, zh, ko, de, pt, ja, it, fr, sv, ru, es, nl.
commands.dueDateUtcDatePickerNote that, when the dueDateUtc argument is specified, the date_string is required and has to specified as well, and also, the date_string argument will be parsed as local timestamp, and converted to UTC internally, according to the user’s profile settings.
commands.minuteOffsetNumberThe relative time in minutes before the due date of the item, in which the reminder should be triggered. Note, that the item should have a due date set in order to add a relative reminder.
commands.nameStringAn alias name for the location.
commands.coordinatesMapLocation longitude and location latitude.
commands.locTriggerStringWhat should trigger the reminder: on_enter for entering the location, or on_leave for leaving the location.
commands.radiusNumberThe radius around the location that is still considered as part of the location (in meters).

Todoist.deleteReminder

Delete a reminder from the user account related to the API credentials.Is only available for Todoist Premium.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.idStringThe id of the reminder.

Todoist.clearLocations

Clears the locations list, which is used for the location reminders.Is only available for Todoist Premium.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.

Todoist.getProductivityStats

Get the user’s productivity stats.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.

Todoist.getAllCompletedItems

Only available for Todoist Premium users.Get all the user’s completed items (tasks).Is only available for Todoist Premium.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
projectIdStringFilter the tasks by project id.
limitNumberThe number of items to return (where the default is 30, and the maximum is 50).
offsetNumberCan be used for pagination, when more than the limit number of tasks are returned.
untilDatePickerReturn items with a completed date same or older than until (a string value formatted as 2007-4-29T10:13).
sinceDatePickerReturn items with a completed date newer than since (a string value formatted as 2007-4-29T10:13).
annotateNotesSelectReturn notes together with the completed items (a true or false value).

Todoist.getArchivedProjects

Get the user’s archived projects.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.

Todoist.getItemInfo

This function is used to extract detailed information about the item, including all the notes.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
itemIdStringThe item’s unique id.
allDataSelectWhether to return the parent project and notes of the item (a true or false value, while the default is true).

Todoist.getProjectInfo

This function is used to extract detailed information about the project, including all the note

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
projectIdStringThe project’s unique id.
allDataSelectWhether to return the parent project and notes of the item (a true or false value, while the default is true).

Todoist.getProjectData

Get a project’s uncompleted items.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
projectIdStringThe project’s unique id.

Todoist.quickAddTask

Add a new task using the Quick Add Task implementation available in the official clients.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
textStringThe text of the task that is parsed. It can include a due date in free form text, a project name starting with the # character, a label starting with the @ character, and an assignee starting with the + character.
noteStringThe content of the note.
reminderDatePickerThe date of the reminder, added in free form text.

Todoist.registerNewUser

Register a new user.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
emailStringThe user’s email.
fullNameStringThe user’s real name formatted as Firstname Lastname.
passwordStringThe user’s password.
langSelectThe user’s language.
timezoneStringThe user’s timezone (a string value such as UTC, Europe/Lisbon, US/Eastern, Asian/Taipei). By default we use the user’s IP address to determine the timezone.

Todoist.updateUsersProperties

Update user’s properties

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.emailStringThe user’s email.
commands.fullNameStringThe user’s real name formatted as Firstname Lastname.
commands.passwordStringThe user’s password.
commands.timezoneStringThe user’s timezone (a string value such as UTC, Europe/Lisbon, US/Eastern, Asian/Taipei).
commands.startPageStringThe user’s default view on Todoist. The start page can be one of the following: _info_page for the info page, _blank for a blank page, project<PROJECT_ID> for project with id <PROJECT_ID>, and <ANY_QUERY> to query after anything.
commands.startDayNumberThe first day of the week (between 1 and 7, where 1 is Monday and 7 is Sunday).
commands.nextWeekNumberArray of Command object. Each command will be processed in the specified order.
commands.timeFormatNumberThe day of the next week, that tasks will be postponed to (between 1 and 7, where 1 is Monday and 7 is Sunday).
commands.dateFormatSelectWhether to use the DD-MM-YYYY date format or the MM-DD-YYYY .Options - MM-DD-YYYY,DD-MM-YYYY.
commands.sortOrderSelectWhether to show projects in an oldest dates first order or oldest dates last order . Options - oldestDatesLast,oldestDatesFirst.
commands.defaultReminderStringThe default reminder for the user. Reminders are only possible for Premium users. The default reminder can be one of the following: email to send reminders by email, mobile to send reminders to mobile devices via SMS, push to send reminders to smart devices using push notifications (one of the Android or iOS official clients must be installed on the client side to receive these notifications), no_default to turn off sending default reminders.
commands.autoReminderNumberThe default time in minutes for the automatic reminders set, whenever a due date has been specified for a task.
commands.mobileNumberStringThe user’s mobile number (null if not set).
commands.mobileHostStringThe user’s mobile host (or null if not set).
commands.themeNumberThe currently selected Todoist theme (between 0 and 10).

Todoist.updateKarmaGoals

Update the karma goals of the user.Is only available for Todoist Premium.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the syncStatus field of the response JSON object. The syncStatus object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.dailyGoalNumberThe target number of tasks to complete per day.
commands.weeklyGoalNumberThe target number of tasks to complete per week.
commands.ignoreDaysNumberA list with the days of the week to ignore (1 for Monday and 7 for Sunday).
commands.vacationModeSelectMarks the user as being on vacation (where 1 is true and 0 is false).Options - true,false.
commands.karmaDisabledSelectWhether to disable the karma and goals measuring altogether (where 1 is true and 0 is false).Options - true,false.

Todoist.updateNotificationSettings

Update the user’s notification settings.Is only available for Todoist Premium.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
notificationTypeListThe notification type.
serviceSelectThe service type, which can take the values: email or push.
dontNotifySelectWhether notifications of this service should be notified (1 to not notify, and 0 to notify).

Todoist.shareProject

Share a project with another user.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the syncStatus field of the response JSON object. The syncStatus object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.projectIdStringThe project to be shared.
commands.emailStringThe user email with whom to share the project.

Todoist.deleteCollaborator

Share a project with another user.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.projectIdStringThe project to be shared.
commands.emailStringThe user email with whom to share the project.

Todoist.acceptInvitation

Accept an invitation to join a shared project.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.invitationIdNumberThe invitation id.
commands.invitationSecretNumberThe secret fetched from the live notification.

Todoist.rejectInvitation

Reject an invitation to join a shared project.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.invitationIdNumberThe invitation id.
commands.invitationSecretNumberThe secret fetched from the live notification.

Todoist.deleteInvitation

Delete an invitation to join a shared project.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.invitationIdNumberThe invitation id.

Todoist.setLastKnown

Set the last known notification.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.idNumberThe id of the last known notification (a number or 0 or null to mark all read).

Todoist.markAsRead

Mark the notification as read.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.idNumberThe id of the notification.

Todoist.markAllAsRead

Mark all notifications as read.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.

Todoist.markAsUnread

Mark the notification as unread.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsArrayArray of Command object. Each command will be processed in the specified order.
commands.uuidStringAPI clients should generate a unique string ID for each command and specify it in the uuid field. The Command UUID will be used for two purposes: 1.Command result mapping: Each command’s result will be stored in the sync_status field of the response JSON object. The sync_status object has its key mapped to a command’s uuid and its value containing the result of a command.2.Command idempotency: Todoist will not execute command that has same UUID as the previously executed commands. This will allow clients to safely retry each command without accidentally performing the command twice.
commands.idNumberThe id of the notification.

Todoist.sendInvitation

This function allows you to send invitation to your business account. Every invitation object has an unique id and secret code.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
emailListListThe emails of users which will be invited.
messageStringAdditional text which will be included to invitation welcome message.

Todoist.acceptBusinessInvitation

This function allows you to send invitation to your business account. Every invitation object has an unique id and secret code.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
idNumberThe invitation id (a number).
secretStringThe secret fetched from the live notification (a string value).

Todoist.rejectBusinessInvitation

The invitation is rejected and deleted. Note that the client doesn’t have to provide the user’s token to reject invitation: it’s enough to provide knowledge of invitation secret business account yet.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
invitationIdNumberThe invitation id (a number).
secretStringThe secret fetched from the live notification (a string value).

Todoist.getActivityLogs

Get activity logs.Is only available for Todoist Premium.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
objectTypeStringFilters events by a specific object type.
objectIdNumberFilters events by a specific object id, but only if the objectType has been also specified.
eventTypeStringFilters events by a specific event type.
objectEventTypesStringAn alternative way to filter by multiple object and event types. This takes a list of strings of the form [object_type]:[event_type] (where either object_type part or the event_type part can be omitted), such as for example [item:, note:added]. When this parameter is specified the object_type, event_type and object_id parameters are ignored.
parentProjectIdNumberFilters object events by the id of the project they belong to, so this implicitly limits the results to items and notes.
parentItemIdNumberFilters object events by the id of the project they belong to, so this implicitly limits the results to items and notes.
initiatorIdNumberFilters event by the id of the initiator.
sinceDatePickerReturn items with a completed date newer than since (a string value formatted as 2007-4-29T10:13).
untilDatePickerReturn items with a completed date same or older than until (a string value formatted as 2007-4-29T10:13).
limitNumberThe number of events to return, where the default is 30, and the maximum is 100.
offsetNumberThe number of events to skip, which can be used for pagination in order to get more events than those returned by the previous call.

Todoist.getBackups

Todoist creates a backup archive of users’ data on a daily basis. Backup archives can also be accessed from the web app (Todoist Settings -> Backups).

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.

Todoist.createObjectEmail

Creates a new email address for an object.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
objTypeSelectThe object’s type.
objIdNumberThe object’s id.

Todoist.getObjectEmail

Gets an existing email.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
objTypeSelectThe object’s type.Options - project, project_comments or item.
objIdNumberThe object’s id.

Todoist.disableObjectEmail

Disables an email address for an object.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
objTypeSelectThe object’s type.Options - project, project_comments or item.
objIdNumberThe object’s id.

Todoist.getUploadsFiles

Get all user’s uploads.

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
limitNumberThe number of items to return (a number, where the default is 30, and the maximum is 50).
lastIdNumberCan be used for pagination. This should be the minimum upload id you’ve fetched so far. All results will be listed before that id.

Todoist.deleteExistingUser

Delete an existing user

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
currentPasswordStringThe user’s current password.
reasonForDeleteStringA reason for deletion, that is used for sending feedback back to Todoist.

Todoist.createMultipleCommand

Create request with multiple command. See more about multiple commands here

FieldTypeDescription
accessTokenStringAccess token obtained from the OAuth authentication.
commandsJSONArray of Command object. Each command will be processed in the specified order.
x
circle
Todoist
$ / m
We will charge your card every month for the plan amount, as well as any overages incurred in the previous month.
?

Oops, we are missing some details

Looks like there are a few missing details that you haven't filled in yet.
These details are important and will help us protect you and let you know about anything new.

x

Login to RapidAPI

Create endpoints based on popular APIs and share with others.
Follow popular APIs and get updated. Stand out in the community of developers.

LOG INSIGN UP
Login with Github
Login with Facebook
Login with Google
Or
Remember Me

  • We're not going to post anything on your wall.
  • We're not planning to spam you.
  • esccloses this view
    x

    Why sign up to RapidAPI?

    • integrate
      Integrate APIs into your app
      Ruby, Java, Elixir, Node.js, Phyton, Objective C, Swift, PHP and MORE
    • keys
      Save all API keys in one place
    • notifications
      Get notifications about API changes
    • stats
      Get stats and monitor API connections
    Sign up with Github
    Sign up with Facebook
    Sign up with Google
  • We're not going to post anything on your wall.
  • We're not planning to spam you.
  • esccloses this view
    x

    Authentication

    Authenticate
    esccloses this view