> For the complete documentation index, see [llms.txt](https://agpt.co/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://agpt.co/docs/integrations/block-integrations/projects-1.md). # 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. *** --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://agpt.co/docs/integrations/block-integrations/projects-1.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.