Files
AutoGPT/docs/integrations/block-integrations/todoist/projects.md
Nicholas Tindle 90466908a8 refactor(docs): restructure platform docs for GitBook and remove MkDo… (#11825)
<!-- Clearly explain the need for these changes: -->
we met some reality when merging into the docs site but this fixes it
### Changes 🏗️
updates paths, adds some guides
<!-- Concisely describe all of the changes made in this pull request:
-->
update to match reality
### Checklist 📋

#### For code changes:
- [x] I have clearly listed my changes in the PR description
- [x] I have made a test plan
- [x] I have tested my changes according to the test plan:
  <!-- Put your test plan here: -->
  - [x] deploy it and validate

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Aligns block integrations documentation with GitBook.
> 
> - Changes generator default output to
`docs/integrations/block-integrations` and writes overview `README.md`
and `SUMMARY.md` at `docs/integrations/`
> - Adds GitBook frontmatter and hint syntax to overview; prefixes block
links with `block-integrations/`
> - Introduces `generate_summary_md` to build GitBook navigation
(including optional `guides/`)
> - Preserves per-block manual sections and adds optional `extras` +
file-level `additional_content`
> - Updates sync checker to validate parent `README.md` and `SUMMARY.md`
> - Rewrites `docs/integrations/README.md` with GitBook frontmatter and
updated links; adds `docs/integrations/SUMMARY.md`
> - Adds new guides: `guides/llm-providers.md`,
`guides/voice-providers.md`
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
fdb7ff8111. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: bobby.gaffin <bobby.gaffin@agpt.co>
2026-01-23 06:18:16 +00:00

5.5 KiB

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.