Todoist Projects

Blocks for creating and managing projects in Todoist.

Todoist Create Project

What it is

Creates a new project in Todoist

How it works

Takes project details and creates via Todoist API.

Inputs

Input
Description
Type
Required

name

Name of the project

str

Yes

parent_id

Parent project ID

str

No

color

Color of the project icon

"berry_red" | "red" | "orange" | "yellow" | "olive_green" | "lime_green" | "green" | "mint_green" | "teal" | "sky_blue" | "light_blue" | "blue" | "grape" | "violet" | "lavender" | "magenta" | "salmon" | "charcoal" | "grey" | "taupe"

No

is_favorite

Whether the project is a favorite

bool

No

view_style

Display style (list or board)

str

No

Outputs

Output
Description
Type

error

Error message if the operation failed

str

success

Whether the creation was successful

bool

Possible use case

Creating new projects programmatically for workflow automation.


Todoist Delete Project

What it is

Deletes a Todoist project and all its contents

How it works

Uses project ID to delete via Todoist API.

Inputs

Input
Description
Type
Required

project_id

ID of project to delete

str

Yes

Outputs

Output
Description
Type

error

Error message if the operation failed

str

success

Whether the deletion was successful

bool

Possible use case

Removing completed or obsolete projects.


Todoist Get Project

What it is

Gets details for a specific Todoist project

How it works

Uses project ID to retrieve details via Todoist API.

Inputs

Input
Description
Type
Required

project_id

ID of the project to get details for

str

Yes

Outputs

Output
Description
Type

error

Error message if the operation failed

str

project_id

ID of project

str

project_name

Name of project

str

project_url

URL of project

str

complete_data

Complete project data including all fields

Dict[str, Any]

Possible use case

Looking up project details for verification or editing.


Todoist List Collaborators

What it is

Gets all collaborators for a specific Todoist project

How it works

Uses project ID to get collaborator list via Todoist API.

Inputs

Input
Description
Type
Required

project_id

ID of the project to get collaborators for

str

Yes

Outputs

Output
Description
Type

error

Error message if the operation failed

str

collaborator_ids

List of collaborator IDs

List[str]

collaborator_names

List of collaborator names

List[str]

collaborator_emails

List of collaborator email addresses

List[str]

complete_data

Complete collaborator data including all fields

List[Dict[str, Any]]

Possible use case

Managing project sharing and collaboration.


Todoist List Projects

What it is

Gets all projects and their details from Todoist

How it works

Connects to Todoist API using provided credentials and retrieves all projects.

Outputs

Output
Description
Type

error

Error message if the operation failed

str

names_list

List of project names

List[str]

ids_list

List of project IDs

List[str]

url_list

List of project URLs

List[str]

complete_data

Complete project data including all fields

List[Dict[str, Any]]

Possible use case

Getting an overview of all projects for organization or automation.


Todoist Update Project

What it is

Updates an existing project in Todoist

How it works

Takes project ID and updated fields, applies via Todoist API.

Inputs

Input
Description
Type
Required

project_id

ID of project to update

str

Yes

name

New name for the project

str

No

color

New color for the project icon

"berry_red" | "red" | "orange" | "yellow" | "olive_green" | "lime_green" | "green" | "mint_green" | "teal" | "sky_blue" | "light_blue" | "blue" | "grape" | "violet" | "lavender" | "magenta" | "salmon" | "charcoal" | "grey" | "taupe"

No

is_favorite

Whether the project should be a favorite

bool

No

view_style

Display style (list or board)

str

No

Outputs

Output
Description
Type

error

Error message if the operation failed

str

success

Whether the update was successful

bool

Possible use case

Modifying project settings or reorganizing projects.


Last updated

Was this helpful?