mirror of
https://github.com/Significant-Gravitas/AutoGPT.git
synced 2026-01-20 20:48:11 -05:00
a44c9333d3
- Resolves - #9303 and #9304 - Depends on - https://github.com/Significant-Gravitas/AutoGPT/pull/9319 ### Blocks list Block Name | What It Does | Manually Tested -- | -- | -- Todoist Create Label | Creates a new label in Todoist | ✅ Todoist List Labels | Retrieves all personal labels from Todoist | ✅ Todoist Get Label | Retrieves a specific label by ID | ✅ Todoist Create Task | Creates a new task in Todoist | ✅ Todoist Get Tasks | Retrieves active tasks from Todoist | ✅ Todoist Update Task | Updates an existing task | ✅ Todoist Close Task | Completes/closes a task | ✅ Todoist Reopen Task | Reopens a completed task | ✅ Todoist Delete Task | Permanently deletes a task | ✅ Todoist List Projects | Retrieves all projects from Todoist | ✅ Todoist Create Project | Creates a new project in Todoist | ✅ Todoist Get Project | Retrieves details for a specific project | ✅ Todoist Update Project | Updates an existing project | ✅ Todoist Delete Project | Deletes a project and its contents | ✅ Todoist List Collaborators | Retrieves collaborators on a project | ✅ Todoist List Sections | Retrieves sections from Todoist | ✅ Todoist Get Section | Retrieves details for a specific section | ✅ Todoist Delete Section | Deletes a section and its tasks | ✅ Todoist Create Comment | Creates a new comment on a task or project | ✅ Todoist Get Comments | Retrieves all comments for a task or project | ✅ Todoist Get Comment | Retrieves a specific comment by ID | ✅ Todoist Update Comment | Updates an existing comment | ✅ Todoist Delete Comment | Deletes a comment | ✅ > I’ve only created action blocks in Todoist because webhooks can only be manually created [we can't do it programatically right now]. I’ve already emailed Todoist for help, but they haven’t replied yet. Once I receive a reply, I’ll create a pull request for webhook triggers in Todoist.
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.
|