Todoist: template_typerequired | string (Template Type) Saved templates support project content only. Value: "project"
for_workspace | boolean (For Workspace) Default: false Associate with the source project workspace as a restricted template. Defaults to a personal template.
Todoist: Get Workspaces Users
Returns all workspace_users for a given workspace if workspace_id is provided. Otherwise, returns all workspace_users for all workspaces that the requesting user is part of.
Not accessible by guests.
Todoist: Preview Template
Preview a project or setup template without importing it.
Curated templates support anonymous access and use a valid data:read actor when available. Any UT_ ID requires data:read and the saved template's existing visibility permissions. Raw date strings are supported only for project templates.
Todoist: Joining by Domain This is possible if: The user is verified The user has a user e-mail belonging to a domain that is set as a domain name for a workspace That workspace has the auto-join by domain feature enabled
Todoist: Delete Invitation
Deletes a workspace invitation. Only admins can delete invitations.
Todoist: Change the role of a workspace user. Admins or members can not be downgraded to guests. This command is only usable by workspace admins. Other users will get a “forbidden” error.
Starter: Argument | Required | Description
role String | No | The role the user will be given if they accept the invite. Possible values are ADMIN, MEMBER, and GUEST. If not provided, the default value according to the plan will be used. For Starter plans, the default is ADMIN and for Business plans, the default is MEMBER.
Todoist: User Info
Get information about the currently authenticated user.
This is the OIDC userinfo endpoint. OAuth tokens of any product audience are accepted as long as they carry the user:read scope (implied by data:read).
Todoist: Default collaborators for new projects. Object with user_ids (array of integers) and predefined_group_ids (array of strings). If not provided or set to null then by default all workspace members are added as the default collaborators.
Todoist: Only users with admin permissions on the project can update PVODs.
Todoist: Project access configuration with visibility ("restricted", "team", or "public") and configuration object. For public projects, configuration includes hide_collaborator_details and disable_duplication booleans. Only used for teams
Todoist: Name | Description
data:read | Grants read-only access to application data, including tasks, projects, labels, and filters.
Todoist: Change user role
Business: Argument | Required | Description
role String | No | The role the user will be given if they accept the invite. Possible values are ADMIN, MEMBER, and GUEST. If not provided, the default value according to the plan will be used. For Starter plans, the default is ADMIN and for Business plans, the default is MEMBER.
Todoist: True if users are allowed to join the workspace using an invitation link. Default value is True. For guests, this field will be set to null as guests are not allowed to have access to this field.
Todoist: Delete Filter
Delete a personal filter.
Only available on plans that include filters. Returns a not found error if the filter doesn't exist, was already deleted, or belongs to another user. Workspace filters can't be deleted with this endpoint.
Todoist: You can make team projects private, too.
Todoist: Export As Url
Publish a project as a shareable template URL. Requires data:read_write and project export permission.
Todoist: Administrators may also: (a) manage the access permissions of Workspace Authorized Users of the Workspace;
Todoist: The backups:read scope bypasses MFA and only grants access to GET /api/v1/backups. When using data:read_write or a personal API token for an account with MFA enabled, the MFA token is required.
Todoist: Workspace projects can only be deleted by ADMINs and it must be archived first.
Todoist: Name | Description
data:delete | Grants permission to delete application data, including tasks, labels, and filters.
Todoist: Personal projects stay separate from team work by default.
Todoist Business: Access to any shared projects must be granted by the account administrator from the control panel.
Todoist Business: manage granting account access to additional users through an administrative interface
Todoist: A saved workspace template can only be used in its associated workspace.
Todoist: True if users from outside the workspace are allowed to join or be invited to workspace projects. Default value is True.
Todoist: Default access level for new projects in the workspace. Possible values: restricted, team (default).
Todoist: Moves a project inside a workspace out back into a user's personal space.
When use_lro=true is passed, this command creates a Long Running Operation (LRO) and processes the move in the background. The sync_status will contain an operation object instead of "ok".
Deprecation notice: The synchronous behavior (without use_lro) is deprecated and will be removed in a future version. In that version, this command will always use LRO. We recommend migrating to only rely on use_lro=true.
Only the original creator of the project has permissions to do this, and only if they are still currently an admin of said workspace.
Todoist: All Invitations
Return a list containing details of all pending invitation to a workspace.
This list is not paginated. All workspace members can access this list.
Todoist: This endpoint is used to join a workspace project by a workspace_user and is only usable by the workspace user.
Todoist: Discover Templates
Discover templates or look up a bounded batch of IDs.
Curated templates are anonymous. Personal/workspace sources and any UT_ ID require data:read.
Todoist: When sharing a teams project
Workspace projects with is_invite_only set to true can only be shared by workspace admins, or by project members with ADMIN or CREATOR role. Other users will get a “forbidden” error. The role for the new collaborator cannot be greater than the role of the person sharing the project.
Todoist: Active Projects
Returns all active workspace projects, including those visible but not joined by the user.
For guests, returns all joined workspace projects only.
Todoist: Role assigned to invited users.
Todoist: Migrate Personal Token
Tokens obtained via the old email/password authentication method can be migrated to the new OAuth access token. Migrating your users' personal tokens will allow users to see your app in their Todoist Settings page and give them the ability to manage their app authorization.
Todoist: We provide you with settings to allow you to set your sharing preferences for content you post to the Services.
Todoist: Name | Description
backups:read | Grants permission to list backups with GET /api/v1/backups without MFA. Downloading a backup with GET /api/v1/backups/download still requires data:read_write.
Todoist: boolean (Is Guest Allowed) Default: true Whether guests are allowed in the workspace.
Todoist: Revoke Token Rfc7009 Compliant
Revoke an access token according to RFC 7009 OAuth Token Revocation.
This endpoint accepts form-encoded data and follows the OAuth 2.0 Token Revocation specification. The client must authenticate using HTTP Basic authentication with their client credentials.
Todoist: A shared workspace template can be edited by its author or a workspace admin; restricted templates remain author-only, and only the author may change sharing.
Todoist: Moving a project to a workspace affects all its collaborators. Collaborators who are not members of the target workspace will be added as guests, if guest members are allowed in the target workspace
Todoist: Google Accounts authentication via OAuth 2.0
Todoist: Discover Template
Get one template. A UT_ ID requires data:read; invisible or missing IDs return 404.
Todoist: True if users with e-mail addresses in the workspace domain can join the workspace without an invitation.
Todoist: The role a user can have. Possible values: CREATOR, ADMIN, READ_WRITE, EDIT_ONLY, COMPLETE_ONLY. (CREATOR is equivalent to admin and is automatically set at project creation; it can't be set to anyone later). Defaults to READ_WRITE. Only used for teams
Todoist: Returns a list of all the available roles and the associated actions they can perform in a project.
Todoist: Name | Description
project:delete | Grants permission to delete projects.
Todoist: The role of the requesting user in this workspace. Possible values are: ADMIN, MEMBER or GUEST. A guest is someone who is a collaborator of a workspace project, without being an actual member of the workspace. This field can be null if the requesting user is not part of the workspace. For example, when receiving the workspace deletion related sync update when a user leaves or is removed from a workspace.
Todoist: To change whether certain information is viewable and accessible, you can adjust the settings in your workspace.
Todoist: Download Backup
Download a backup archive.
This endpoint requires the data:read_write scope. The backups:read scope only grants access to GET /api/v1/backups.
Todoist: Workspace guests cannot list archived projects and receive a FORBIDDEN error.
Todoist: Updates a workspace user's role.
Todoist: The role to be assigned to the new member. Valid values are GUEST, MEMBER and ADMIN.
Todoist: If False, the project is invite-only and people can't join by link. If true, the project is visible to anyone with a link, and anyone can join it. Only used for teams
Todoist: This is intended for public clients that cannot safely store a client_secret (browser-based SPAs, desktop apps, MCP servers). Clients protect themselves with PKCE during the authorization code exchange instead of a client secret.
Todoist: Change the role a project member has within the project.
Command arguments
Argument | Required | Description
id String | Yes | ID of the project to change the role for (could be a temp id).
user_id Int | Yes | ID of the user whose role to change.
role String | Yes | New role for the user. Valid values: CREATOR, ADMIN, READ_WRITE, EDIT_ONLY, COMPLETE_ONLY. Note: Only the project creator can be assigned the CREATOR role.
Todoist: boolean (Restrict Email Domains) Default: false Whether workspace invites are restricted to workspace domain.
Todoist: Todoist MCP
Integrate AI assistants with Todoist using the Model Context Protocol (MCP), an open standard for secure access to your tasks and projects. Our hosted MCP server works with Claude, ChatGPT, Cursor, and VS Code.
Easy setup: OAuth in a minute.
Todoist: Project access configuration. Contains visibility ("restricted", "team", or "public") and configuration object. For public projects, configuration includes hide_collaborator_details and disable_duplication booleans. Only used for teams
Todoist: Export As File
Download a project as UTF-8 CSV. Requires data:read and project export permission.
Todoist: Permission scopes
Name | Description
task:add | Grants permission to add new tasks (the application cannot read or modify any existing data).
Todoist: Indicates if users are allowed to join the workspace using an invitation link. Default value is True.
Todoist: Accept Invitation
Accept a workspace invitation. Usable by authenticated users only.
Todoist: A comma separated subset of the originally granted scopes. Clients may request a narrower set of scopes; requesting scopes beyond the original grant returns an error.
Todoist: The actions each role in the system are allowed to perform on a project
Todoist: Name | Description
data:read_write | Grants read and write access to application data, including tasks, projects, labels, and filters. This scope includes task:add and data:read scopes.
Todoist: blocked, for users that have failed to verify themselves in 7 days. Those users will have restricted usage of Todoist.
Todoist: If the Administrator of a Workspace terminates their account, then all Workspace Authorized Users of that Workspace will no longer have access to that Workspace, which includes any User Content contained that Workspace.
Todoist Business: two different user roles and access privileges: admin and user
Todoist: チームの役割&許可設定
Todoist: Guests will not receive workspace_users sync events or resources.
Todoist: email/password-based authentication
Todoist: boolean (Is Link Sharing Enabled) Default: true Whether link sharing is enabled for the workspace.
Todoist: Validates that the requested backup belongs to the authenticated user and redirects to a signed CloudFront URL that expires after one minute.
Todoist: The Administrator may grant other Workspace Authorized Users access to the Workspace, or revoke access to the Workspace.
Todoist: User item orders
A user item order places one task in one of the user's personal orderings. Each object is one task's position in one ordering, held as a fractional-indexing order_key rather than an integer: rows sort by comparing keys lexicographically within a scope. These orderings are private to the user and are not shared with a project's collaborators.
Todoist: Revoke the access tokens obtained via OAuth
Todoist: Indicates if users from outside the workspace are allowed to join or be invited to workspace projects. Default value is True.
Todoist: In Teams, only workspace admins or project members with ADMIN or CREATOR role can delete a collaborator.
ビジネス: チームの役割&許可設定
Todoist: Property | Description
restrict_email_domains Boolean | True if only users with e-mail addresses in the workspace domain can join the workspace.
Todoist: You are solely liable and responsible for understanding the settings, privileges and controls for the Service and for controlling whom you permit to access your Workspace (each a, "Workspace Authorized User") and what the settings and privileges are for such a Workspace Authorized User, including, the right for a Workspace Authorized User to invite others (either paid or unpaid), the right to incur charges on your account, the right to access or modify User Content, etc.
Todoist: Indicates if the project is invite-only or if it should be visible for everyone in the workspace. If missing or null, the default value from the workspace is_invite_only_default will be used. Only used for teams
Todoist Business: Todoist Business Admin Controls
For Todoist Business accounts, we provide two different user roles and access privileges: admin and user.
Account administrators have access to the central control panel to manage billing information, users, and sharing settings. Access to any shared projects must be granted by the account administrator from the control panel.
Sharing Settings allows the administrator to choose between restricting sharing to only employees within the organization or allowing sharing outside of the organization (e.g., with clients, vendors, etc.).
Todoist: Use Template
Create a project or a complete setup from a template. Requires data:read_write.
Todoist: Workspace projects with is_invite_only set to true can only be shared by workspace admins, or by project members with ADMIN or CREATOR role.
Todoist: OAuth
OAuth is also available for token generation. It's especially useful for external applications to obtain a user authorized API token via the OAuth2 protocol.
Todoist: controlling whom you permit to access your Workspace
Todoist: Workspace filters require membership in the associated workspace
Todoist: Admins set permissions and data access
Todoist: Curated previews allow anonymous access. Saved templates require data:read and retain their personal or workspace visibility rules.
Todoist: Response
Dynamic clients are identified by a tdd_ prefix on client_id. The client_secret_expires_at field is 0 — client secrets do not expire. Use the returned credentials with the standard authorization code flow above.
Todoist: Delete Upload
Delete an uploaded file.
The file must belong to the authenticated user. Returns FILE_NOT_FOUND when the upload cannot be found.
Todoist: register through a third party account (such as Apple, Facebook or Google)