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.
16 KiB
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.