mirror of
https://github.com/Significant-Gravitas/AutoGPT.git
synced 2026-02-08 05:45:07 -05:00
90466908a8
<!-- 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>
723 lines
16 KiB
Markdown
723 lines
16 KiB
Markdown
# Todoist Blocks
|
|
|
|
## Todoist Create Label
|
|
|
|
### What it is
|
|
A block that creates a new label in Todoist.
|
|
|
|
### What it does
|
|
Creates a new label in Todoist with specified name, order, color and favorite status.
|
|
|
|
### How it works
|
|
It takes label details as input, connects to Todoist API, creates the label and returns the created label's details.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Name | Name of the label |
|
|
| Order | Optional label order |
|
|
| Color | Optional color of the label icon |
|
|
| Is Favorite | Whether label is marked as favorite |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| ID | ID of the created label |
|
|
| Name | Name of the label |
|
|
| Color | Color of the label |
|
|
| Order | Label order |
|
|
| Is Favorite | Favorite status |
|
|
| Error | Error message if request failed |
|
|
|
|
### Possible use case
|
|
Creating new labels to organize and categorize tasks in Todoist.
|
|
|
|
---
|
|
|
|
## Todoist List Labels
|
|
|
|
### What it is
|
|
A block that retrieves all personal labels from Todoist.
|
|
|
|
### What it does
|
|
Fetches all personal labels from the user's Todoist account.
|
|
|
|
### How it works
|
|
Connects to Todoist API using provided credentials and retrieves all labels.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Labels | List of complete label data |
|
|
| Label IDs | List of label IDs |
|
|
| Label Names | List of label names |
|
|
| Error | Error message if request failed |
|
|
|
|
### Possible use case
|
|
Getting an overview of all labels to organize tasks or find specific labels.
|
|
|
|
---
|
|
|
|
## Todoist Get Label
|
|
|
|
### What it is
|
|
A block that retrieves a specific label by ID.
|
|
|
|
### What it does
|
|
Fetches details of a specific label using its ID.
|
|
|
|
### How it works
|
|
Uses the label ID to retrieve label details from Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Label ID | ID of label to retrieve |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| ID | Label ID |
|
|
| Name | Label name |
|
|
| Color | Label color |
|
|
| Order | Label order |
|
|
| Is Favorite | Favorite status |
|
|
| Error | Error message if request failed |
|
|
|
|
### Possible use case
|
|
Looking up details of a specific label for editing or verification.
|
|
|
|
---
|
|
|
|
## Todoist Create Task
|
|
|
|
### What it is
|
|
A block that creates a new task in Todoist.
|
|
|
|
### What it does
|
|
Creates a new task with specified content, description, project assignment and other optional parameters.
|
|
|
|
### How it works
|
|
Takes task details and creates a new task via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Content | Task content |
|
|
| Description | Optional task description |
|
|
| Project ID | Optional project to add task to |
|
|
| Section ID | Optional section to add task to |
|
|
| Parent ID | Optional parent task ID |
|
|
| Order | Optional task order |
|
|
| Labels | Optional task labels |
|
|
| Priority | Optional priority (1-4) |
|
|
| Due Date | Optional due date |
|
|
| Deadline Date | Optional deadline date |
|
|
| Assignee ID | Optional assignee |
|
|
| Duration Unit | Optional duration unit |
|
|
| Duration | Optional duration amount |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| ID | Created task ID |
|
|
| URL | Task URL |
|
|
| Complete Data | Complete task data |
|
|
| Error | Error message if request failed |
|
|
|
|
### Possible use case
|
|
Creating new tasks with full customization of parameters.
|
|
|
|
---
|
|
|
|
## Todoist Get Tasks
|
|
|
|
### What it is
|
|
A block that retrieves active tasks from Todoist.
|
|
|
|
### What it does
|
|
Fetches tasks based on optional filters like project, section, label etc.
|
|
|
|
### How it works
|
|
Queries Todoist API with provided filters to get matching tasks.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Project ID | Optional filter by project |
|
|
| Section ID | Optional filter by section |
|
|
| Label | Optional filter by label |
|
|
| Filter | Optional custom filter string |
|
|
| Lang | Optional filter language |
|
|
| IDs | Optional specific task IDs |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| IDs | List of task IDs |
|
|
| URLs | List of task URLs |
|
|
| Complete Data | Complete task data |
|
|
| Error | Error message if request failed |
|
|
|
|
### Possible use case
|
|
Retrieving tasks matching specific criteria for review or processing.
|
|
|
|
---
|
|
|
|
## Todoist Update Task
|
|
|
|
### What it is
|
|
A block that updates an existing task.
|
|
|
|
### What it does
|
|
Updates specified fields of an existing task.
|
|
|
|
### How it works
|
|
Takes task ID and updated fields, applies changes via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Task ID | ID of task to update |
|
|
| Content | New task content |
|
|
| Description | New description |
|
|
| Project ID | New project ID |
|
|
| Section ID | New section ID |
|
|
| Parent ID | New parent task ID |
|
|
| Order | New order |
|
|
| Labels | New labels |
|
|
| Priority | New priority |
|
|
| Due Date | New due date |
|
|
| Deadline Date | New deadline date |
|
|
| Assignee ID | New assignee |
|
|
| Duration Unit | New duration unit |
|
|
| Duration | New duration |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Success | Whether update succeeded |
|
|
| Error | Error message if failed |
|
|
|
|
### Possible use case
|
|
Modifying task details like due dates, priority etc.
|
|
|
|
---
|
|
|
|
## Todoist Close Task
|
|
|
|
### What it is
|
|
A block that completes/closes a task.
|
|
|
|
### What it does
|
|
Marks a task as complete in Todoist.
|
|
|
|
### How it works
|
|
Uses task ID to mark it complete via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Task ID | ID of task to close |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Success | Whether task was closed |
|
|
| Error | Error message if failed |
|
|
|
|
### Possible use case
|
|
Marking tasks as done in automated workflows.
|
|
|
|
---
|
|
|
|
## Todoist Reopen Task
|
|
|
|
### What it is
|
|
A block that reopens a completed task.
|
|
|
|
### What it does
|
|
Marks a completed task as active again.
|
|
|
|
### How it works
|
|
Uses task ID to reactivate via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Task ID | ID of task to reopen |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Success | Whether task was reopened |
|
|
| Error | Error message if failed |
|
|
|
|
### Possible use case
|
|
Reactivating tasks that were closed accidentally or need to be repeated.
|
|
|
|
---
|
|
|
|
## Todoist Delete Task
|
|
|
|
### What it is
|
|
A block that permanently deletes a task.
|
|
|
|
### What it does
|
|
Removes a task completely from Todoist.
|
|
|
|
### How it works
|
|
Uses task ID to delete via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Task ID | ID of task to delete |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Success | Whether deletion succeeded |
|
|
| Error | Error message if failed |
|
|
|
|
### Possible use case
|
|
Removing unwanted or obsolete tasks from the system.
|
|
|
|
---
|
|
|
|
## Todoist List Projects
|
|
|
|
### What it is
|
|
A block that retrieves all projects from Todoist.
|
|
|
|
### What it does
|
|
Fetches all projects and their details from a user's Todoist account.
|
|
|
|
### How it works
|
|
Connects to Todoist API using provided credentials and retrieves all projects.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Names List | List of project names |
|
|
| IDs List | List of project IDs |
|
|
| URL List | List of project URLs |
|
|
| Complete Data | Complete project data |
|
|
| Error | Error message if request failed |
|
|
|
|
### Possible use case
|
|
Getting an overview of all projects for organization or automation.
|
|
|
|
---
|
|
|
|
## Todoist Create Project
|
|
|
|
### What it is
|
|
A block that creates a new project in Todoist.
|
|
|
|
### What it does
|
|
Creates a new project with specified name, parent project, color and other settings.
|
|
|
|
### How it works
|
|
Takes project details and creates via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Name | Name of the project |
|
|
| Parent ID | Optional parent project ID |
|
|
| Color | Optional color of project icon |
|
|
| Is Favorite | Whether project is favorite |
|
|
| View Style | Display style (list/board) |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Success | Whether creation succeeded |
|
|
| Error | Error message if failed |
|
|
|
|
### Possible use case
|
|
Creating new projects programmatically for workflow automation.
|
|
|
|
---
|
|
|
|
## Todoist Get Project
|
|
|
|
### What it is
|
|
A block that retrieves details for a specific project.
|
|
|
|
### What it does
|
|
Fetches complete details of a single project by ID.
|
|
|
|
### How it works
|
|
Uses project ID to retrieve details via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Project ID | ID of project to get |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Project ID | ID of the project |
|
|
| Project Name | Name of the project |
|
|
| Project URL | URL of the project |
|
|
| Complete Data | Complete project data |
|
|
| Error | Error message if failed |
|
|
|
|
### Possible use case
|
|
Looking up project details for verification or editing.
|
|
|
|
---
|
|
|
|
## Todoist Update Project
|
|
|
|
### What it is
|
|
A block that updates an existing project.
|
|
|
|
### What it does
|
|
Updates specified fields of an existing project.
|
|
|
|
### How it works
|
|
Takes project ID and updated fields, applies via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Project ID | ID of project to update |
|
|
| Name | New project name |
|
|
| Color | New color for icon |
|
|
| Is Favorite | New favorite status |
|
|
| View Style | New display style |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Success | Whether update succeeded |
|
|
| Error | Error message if failed |
|
|
|
|
### Possible use case
|
|
Modifying project settings or reorganizing projects.
|
|
|
|
---
|
|
|
|
## Todoist Delete Project
|
|
|
|
### What it is
|
|
A block that deletes a project and its contents.
|
|
|
|
### What it does
|
|
Permanently removes a project including sections and tasks.
|
|
|
|
### How it works
|
|
Uses project ID to delete via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Project ID | ID of project to delete |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Success | Whether deletion succeeded |
|
|
| Error | Error message if failed |
|
|
|
|
### Possible use case
|
|
Removing completed or obsolete projects.
|
|
|
|
---
|
|
|
|
## Todoist List Collaborators
|
|
|
|
### What it is
|
|
A block that retrieves collaborators on a project.
|
|
|
|
### What it does
|
|
Fetches all collaborators and their details for a specific project.
|
|
|
|
### How it works
|
|
Uses project ID to get collaborator list via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Project ID | ID of project to check |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Collaborator IDs | List of collaborator IDs |
|
|
| Collaborator Names | List of collaborator names |
|
|
| Collaborator Emails | List of collaborator emails |
|
|
| Complete Data | Complete collaborator data |
|
|
| Error | Error message if failed |
|
|
|
|
### Possible use case
|
|
Managing project sharing and collaboration.
|
|
|
|
---
|
|
|
|
## Todoist List Sections
|
|
|
|
### What it is
|
|
A block that retrieves sections from Todoist.
|
|
|
|
### What it does
|
|
Fetches all sections, optionally filtered by project.
|
|
|
|
### How it works
|
|
Connects to Todoist API to retrieve sections list.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Project ID | Optional project filter |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Names List | List of section names |
|
|
| IDs List | List of section IDs |
|
|
| Complete Data | Complete section data |
|
|
| Error | Error message if failed |
|
|
|
|
### Possible use case
|
|
Getting section information for task organization.
|
|
|
|
---
|
|
|
|
## Todoist Get Section
|
|
|
|
### What it is
|
|
A block that retrieves details for a specific section.
|
|
|
|
### What it does
|
|
Fetches complete details of a single section by ID.
|
|
|
|
### How it works
|
|
Uses section ID to retrieve details via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Section ID | ID of section to get |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| ID | Section ID |
|
|
| Project ID | Parent project ID |
|
|
| Order | Section order |
|
|
| Name | Section name |
|
|
| Error | Error message if failed |
|
|
|
|
### Possible use case
|
|
Looking up section details for task management.
|
|
|
|
---
|
|
|
|
## Todoist Delete Section
|
|
|
|
### What it is
|
|
A block that deletes a section and its tasks.
|
|
|
|
### What it does
|
|
Permanently removes a section including all tasks.
|
|
|
|
### How it works
|
|
Uses section ID to delete via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Section ID | ID of section to delete |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Success | Whether deletion succeeded |
|
|
| Error | Error message if failed |
|
|
|
|
### Possible use case
|
|
Removing unused sections or reorganizing projects.
|
|
|
|
---
|
|
|
|
## Todoist Create Comment
|
|
|
|
### What it is
|
|
A block that creates a new comment on a Todoist task or project.
|
|
|
|
### What it does
|
|
Creates a comment with specified content on either a task or project.
|
|
|
|
### How it works
|
|
Takes comment content and task/project ID, creates comment via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Content | Comment content |
|
|
| ID Type | Task ID or Project ID to comment on |
|
|
| Attachment | Optional file attachment |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| ID | ID of created comment |
|
|
| Content | Comment content |
|
|
| Posted At | Comment timestamp |
|
|
| Task ID | Associated task ID |
|
|
| Project ID | Associated project ID |
|
|
| Error | Error message if request failed |
|
|
|
|
### Possible use case
|
|
Adding notes and comments to tasks or projects automatically.
|
|
|
|
---
|
|
|
|
## Todoist Get Comments
|
|
|
|
### What it is
|
|
A block that retrieves all comments for a task or project.
|
|
|
|
### What it does
|
|
Fetches all comments associated with a specific task or project.
|
|
|
|
### How it works
|
|
Uses task/project ID to get comments list via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| ID Type | Task ID or Project ID to get comments for |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Comments | List of comments |
|
|
| Error | Error message if request failed |
|
|
|
|
### Possible use case
|
|
Reviewing comment history on tasks or projects.
|
|
|
|
---
|
|
|
|
## Todoist Get Comment
|
|
|
|
### What it is
|
|
A block that retrieves a specific comment by ID.
|
|
|
|
### What it does
|
|
Fetches details of a single comment using its ID.
|
|
|
|
### How it works
|
|
Uses comment ID to retrieve details via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Comment ID | ID of comment to retrieve |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Content | Comment content |
|
|
| ID | Comment ID |
|
|
| Posted At | Comment timestamp |
|
|
| Project ID | Associated project ID |
|
|
| Task ID | Associated task ID |
|
|
| Attachment | Optional file attachment |
|
|
| Error | Error message if request failed |
|
|
|
|
### Possible use case
|
|
Looking up specific comment details for reference.
|
|
|
|
---
|
|
|
|
## Todoist Update Comment
|
|
|
|
### What it is
|
|
A block that updates an existing comment.
|
|
|
|
### What it does
|
|
Updates the content of a specific comment.
|
|
|
|
### How it works
|
|
Takes comment ID and new content, updates via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Comment ID | ID of comment to update |
|
|
| Content | New content for the comment |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Success | Whether update succeeded |
|
|
| Error | Error message if request failed |
|
|
|
|
### Possible use case
|
|
Modifying existing comments to fix errors or update information.
|
|
|
|
---
|
|
|
|
## Todoist Delete Comment
|
|
|
|
### What it is
|
|
A block that deletes a comment.
|
|
|
|
### What it does
|
|
Permanently removes a comment from a task or project.
|
|
|
|
### How it works
|
|
Uses comment ID to delete via Todoist API.
|
|
|
|
### Inputs
|
|
| Input | Description |
|
|
|-------|-------------|
|
|
| Credentials | Todoist API credentials |
|
|
| Comment ID | ID of comment to delete |
|
|
|
|
### Outputs
|
|
| Output | Description |
|
|
|--------|-------------|
|
|
| Success | Whether deletion succeeded |
|
|
| Error | Error message if request failed |
|
|
|
|
### Possible use case
|
|
Removing outdated or incorrect comments from tasks/projects.
|