Todoist
todoistTodoist is a task management tool allowing users to create to-do lists, set deadlines, and collaborate on projects with reminders and cross-platform syncing
Acciones disponibles (31)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Add WorkspaceTODOIST_ADD_WORKSPACEAcciónTool to create a new workspace in todoist. use when you need a separate workspace to organize projects. generates uuid and temp id automatically.
TODOIST_ADD_WORKSPACEAcciónTool to create a new workspace in todoist. use when you need a separate workspace to organize projects. generates uuid and temp id automatically.
Parámetros de entrada
iconstringIcon for the workspace (optional).
namestringObligatorioName of the new workspace.
uuidstringUUID for this command for idempotency. If omitted, a new UUID is generated.
colorintegerColor ID for the workspace (optional).
temp_idstringTemporary identifier to map the command to the created resource. If omitted, a new UUID is generated.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Close TaskTODOIST_CLOSE_TASKAcciónThis tool marks an existing task as completed in todoist. it requires the `task id` of the task to be closed.
TODOIST_CLOSE_TASKAcciónThis tool marks an existing task as completed in todoist. it requires the `task id` of the task to be closed.
Parámetros de entrada
task_idstringObligatorioThe ID of the task to close.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create CommentTODOIST_CREATE_COMMENTAcciónTool to create a new comment in todoist. use when you need to add a note to a specific task or project after confirming its id.
TODOIST_CREATE_COMMENTAcciónTool to create a new comment in todoist. use when you need to add a note to a specific task or project after confirming its id.
Parámetros de entrada
contentstringObligatorioThe content of the comment.
task_idstringThe ID of the task to attach the comment to. Required if project_id is not provided.
project_idstringThe ID of the project to attach the comment to. Required if task_id is not provided.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create LabelTODOIST_CREATE_LABELAcciónCreates a new label.
TODOIST_CREATE_LABELAcciónCreates a new label.
Parámetros de entrada
namestringObligatorioName of the label.
colorintegerenumColor of the label. See https://developer.todoist.com/guides/#colors for available colors.
303132333435363738394041+8orderintegerThe order of the label in the list.
is_favoritebooleanWhether the label is a favorite.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create ProjectTODOIST_CREATE_PROJECTAcciónCreates a new project in todoist.
TODOIST_CREATE_PROJECTAcciónCreates a new project in todoist.
Parámetros de entrada
namestringObligatorioName of the project.
colorstringenumEnum for project colors. Names are based on Todoist's standard palette.
berry_redredorangeyellowolive_greenlime_greengreenmint_greentealsky_bluelight_blueblue+8favoritebooleanWhether the project should be marked as a favorite.
parent_idstringID of the parent project to create a sub-project. If not set, it's a top-level project.
view_stylestringenumEnum for project view styles.
listboard
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create SectionTODOIST_CREATE_SECTIONAcciónTool to create a new section within a specific project. use when you need to group tasks under a new heading in a project.
TODOIST_CREATE_SECTIONAcciónTool to create a new section within a specific project. use when you need to group tasks under a new heading in a project.
Parámetros de entrada
namestringObligatorioName of the new section.
orderintegerPosition of this section within the project. Sections with lower values appear first.
project_idintegerObligatorioID of the project to create the section in.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create taskTODOIST_CREATE_TASKAcciónCreate a new task in todoist. this action allows users to create tasks with various parameters including content, due dates, priority, and more. the task can be created in a specific project, section, or as a subtask of another task.
TODOIST_CREATE_TASKAcciónCreate a new task in todoist. this action allows users to create tasks with various parameters including content, due dates, priority, and more. the task can be created in a specific project, section, or as a subtask of another task.
Parámetros de entrada
orderintegerNon-zero integer value used to sort tasks under the same parent.
labelsstring[]The task's labels (list of names for personal/shared labels).
contentstringObligatorioTask content/title. Can contain markdown-formatted text and hyperlinks.
due_datestringSpecific date in YYYY-MM-DD format relative to user's timezone.
due_langstring2-letter code specifying language if due_string is not in English.
durationintegerPositive integer for task duration amount.
priorityintegerTask priority from 1 (normal) to 4 (urgent).
parent_idstringParent task ID.
due_stringstringHuman defined task due date (e.g., 'next Monday', 'Tomorrow'). Value is set using local time.
project_idstringProject ID of the task. If not set, task is put to user's Inbox.
section_idstringID of section to put task into.
assignee_idstringThe responsible user ID (only for shared tasks).
descriptionstringTask description. Can contain markdown-formatted text and hyperlinks.
due_datetimestringSpecific date and time in RFC3339 format in UTC.
duration_unitstringUnit for duration - either 'minute' or 'day'.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete LabelTODOIST_DELETE_LABELAcciónTool to delete a specific label. use when you need to permanently remove an unused label by its id after confirming it's not in use. example: "delete label with id 2298391482".
TODOIST_DELETE_LABELAcciónTool to delete a specific label. use when you need to permanently remove an unused label by its id after confirming it's not in use. example: "delete label with id 2298391482".
Parámetros de entrada
label_idstringObligatorioThe ID of the label to delete.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete ProjectTODOIST_DELETE_PROJECTAcciónTool to delete a specific todoist project. use when you need to permanently remove a project by its id.
TODOIST_DELETE_PROJECTAcciónTool to delete a specific todoist project. use when you need to permanently remove a project by its id.
Parámetros de entrada
project_idstringObligatorioThe ID of the project to delete.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete SectionTODOIST_DELETE_SECTIONAcciónTool to delete a specific section. use when you need to permanently remove an unused section by its id after confirming it's not in use. example: "delete section with id 82181370".
TODOIST_DELETE_SECTIONAcciónTool to delete a specific section. use when you need to permanently remove an unused section by its id after confirming it's not in use. example: "delete section with id 82181370".
Parámetros de entrada
section_idstringObligatorioThe ID of the section to delete.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete taskTODOIST_DELETE_TASKAcciónDelete a task from todoist. this action permanently removes the task and all its subtasks.
TODOIST_DELETE_TASKAcciónDelete a task from todoist. this action permanently removes the task and all its subtasks.
Parámetros de entrada
task_idstringObligatorioThe ID of the task to delete.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get All CommentsTODOIST_GET_ALL_COMMENTSAcciónThis tool retrieves all comments associated with a specific task or project in todoist. it requires either a task id or a project id to fetch the comments, and it returns a json array of comment objects with details such as id, posted at, content, and attachment information.
TODOIST_GET_ALL_COMMENTSAcciónThis tool retrieves all comments associated with a specific task or project in todoist. it requires either a task id or a project id to fetch the comments, and it returns a json array of comment objects with details such as id, posted at, content, and attachment information.
Parámetros de entrada
task_idstringThe ID of the task for which to retrieve comments.
project_idstringThe ID of the project for which to retrieve comments.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get all labelsTODOIST_GET_ALL_LABELSAcciónGet all personal labels from todoist. this action retrieves all personal labels from a user's todoist account. each label contains information like name, color, order and favorite status. api documentation: https://developer.todoist.com/rest/v2/#get-all-personal-labels
TODOIST_GET_ALL_LABELSAcciónGet all personal labels from todoist. this action retrieves all personal labels from a user's todoist account. each label contains information like name, color, order and favorite status. api documentation: https://developer.todoist.com/rest/v2/#get-all-personal-labels
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get all projectsTODOIST_GET_ALL_PROJECTSAcciónGet all projects from a user's todoist account. this tool retrieves all projects from the authenticated user's todoist account. the response includes details like project id, name, color, parent project, sharing status, and other metadata for each project.
TODOIST_GET_ALL_PROJECTSAcciónGet all projects from a user's todoist account. this tool retrieves all projects from the authenticated user's todoist account. the response includes details like project id, name, color, parent project, sharing status, and other metadata for each project.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get All SectionsTODOIST_GET_ALL_SECTIONSAcciónTool to retrieve all sections for a specific project in todoist. use when you need to list section structure within a project after selecting the project.
TODOIST_GET_ALL_SECTIONSAcciónTool to retrieve all sections for a specific project in todoist. use when you need to list section structure within a project after selecting the project.
Parámetros de entrada
project_idstringObligatorioThe ID of the project to retrieve sections from.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get All TasksTODOIST_GET_ALL_TASKSAcciónFetches all tasks from todoist and returns their details.
TODOIST_GET_ALL_TASKSAcciónFetches all tasks from todoist and returns their details.
Parámetros de entrada
idsinteger[]List of task IDs to retrieve.
langstringLanguage code for parsing date/times in queries.
filterstringFilter tasks based on filter query (same as UI).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get BackupsTODOIST_GET_BACKUPSAcciónTool to list all available backup archives for the user. use when you need to retrieve and review all existing backups.
TODOIST_GET_BACKUPSAcciónTool to list all available backup archives for the user. use when you need to retrieve and review all existing backups.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get CommentTODOIST_GET_COMMENTAcciónTool to retrieve details of a specific comment by its comment id. use when you need full information (content, timestamp, or attachment) about a known comment.
TODOIST_GET_COMMENTAcciónTool to retrieve details of a specific comment by its comment id. use when you need full information (content, timestamp, or attachment) about a known comment.
Parámetros de entrada
comment_idstringObligatorioThe ID of the comment to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get LabelTODOIST_GET_LABELAcciónTool to retrieve a specific label by its id. use when you need detailed info about a label after you have its id.
TODOIST_GET_LABELAcciónTool to retrieve a specific label by its id. use when you need detailed info about a label after you have its id.
Parámetros de entrada
idstringObligatorioThe ID of the label to retrieve (numeric string).
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get ProjectTODOIST_GET_PROJECTAcciónTool to retrieve a specific project by its id. use when you have a project id and need its metadata before display or update.
TODOIST_GET_PROJECTAcciónTool to retrieve a specific project by its id. use when you have a project id and need its metadata before display or update.
Parámetros de entrada
project_idstringObligatorioThe ID of the project to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get SectionTODOIST_GET_SECTIONAcciónTool to retrieve a specific section by its id. use when you have a section id and need its metadata before display or update.
TODOIST_GET_SECTIONAcciónTool to retrieve a specific section by its id. use when you have a section id and need its metadata before display or update.
Parámetros de entrada
section_idstringObligatorioThe ID of the section to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Special BackupsTODOIST_GET_SPECIAL_BACKUPSAcciónTool to list special backup archives for the user. use when you need to retrieve all project backups for the authenticated user after creating or managing projects.
TODOIST_GET_SPECIAL_BACKUPSAcciónTool to list special backup archives for the user. use when you need to retrieve all project backups for the authenticated user after creating or managing projects.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get TaskTODOIST_GET_TASKAcciónTool to retrieve a specific task by its id. use when you need to fetch all details of an existing task before processing or display.
TODOIST_GET_TASKAcciónTool to retrieve a specific task by its id. use when you need to fetch all details of an existing task before processing or display.
Parámetros de entrada
task_idstringObligatorioThe ID of the task to retrieve.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Archived Workspace ProjectsTODOIST_LIST_ARCHIVED_WORKSPACE_PROJECTSAcciónTool to list all archived projects in a workspace. use when you need to retrieve archived workspace projects with optional filters or pagination.
TODOIST_LIST_ARCHIVED_WORKSPACE_PROJECTSAcciónTool to list all archived projects in a workspace. use when you need to retrieve archived workspace projects with optional filters or pagination.
Parámetros de entrada
limitintegerLimit the number of returned projects.
sincestringReturn archived projects updated after this datetime (ISO 8601).
untilstringReturn archived projects updated before this datetime (ISO 8601).
offsetintegerOffset for pagination.
project_idsstring[]List of project IDs to filter the results.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List FiltersTODOIST_LIST_FILTERSAcciónTool to list all filters for the authenticated user. use when you need to retrieve the current set of custom filters.
TODOIST_LIST_FILTERSAcciónTool to list all filters for the authenticated user. use when you need to retrieve the current set of custom filters.
Parámetros de entrada
sync_tokenstringToken for incremental sync. Use '*' for full sync.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Pending Workspace InvitationsTODOIST_LIST_PENDING_WORKSPACE_INVITATIONSAcciónTool to list pending invitation emails in a workspace. use when you need to check which email invites are still pending acceptance in a workspace.
TODOIST_LIST_PENDING_WORKSPACE_INVITATIONSAcciónTool to list pending invitation emails in a workspace. use when you need to check which email invites are still pending acceptance in a workspace.
Parámetros de entrada
workspace_idstringObligatorioID of the workspace to list pending invitations for.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Reopen TaskTODOIST_REOPEN_TASKAcciónThis tool reopens a previously completed task.
TODOIST_REOPEN_TASKAcciónThis tool reopens a previously completed task.
Parámetros de entrada
task_idstringObligatorioThe ID of the task to reopen.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update CommentTODOIST_UPDATE_COMMENTAcciónTool to update a specific comment's content. use when you need to correct or clarify an existing comment after confirming its id and the new text.
TODOIST_UPDATE_COMMENTAcciónTool to update a specific comment's content. use when you need to correct or clarify an existing comment after confirming its id and the new text.
Parámetros de entrada
contentstringObligatorioNew text content for the comment.
comment_idstringObligatorioThe ID of the comment to update.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update ProjectTODOIST_UPDATE_PROJECTAcciónTool to update a specific project's attributes such as name, color, indent, and order. use when you need to rename or reorder a project after reviewing its current settings. example: "update project 2203306141 name to 'q1 goals'."
TODOIST_UPDATE_PROJECTAcciónTool to update a specific project's attributes such as name, color, indent, and order. use when you need to rename or reorder a project after reviewing its current settings. example: "update project 2203306141 name to 'q1 goals'."
Parámetros de entrada
namestringNew name for the project.
colorintegerNew color ID for the project.
orderintegerNew order position for the project.
indentintegerNew indent level for the project (1-4).
project_idstringObligatorioThe ID of the project to update.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update SectionTODOIST_UPDATE_SECTIONAcciónTool to update a specific section's attributes such as name and order. use when you need to rename or reorder a section after confirming its id.
TODOIST_UPDATE_SECTIONAcciónTool to update a specific section's attributes such as name and order. use when you need to rename or reorder a section after confirming its id.
Parámetros de entrada
namestringNew name for the section. If omitted, the name remains unchanged.
orderintegerNew position of the section within its project (0 is first).
section_idstringObligatorioThe ID of the section to update.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update TaskTODOIST_UPDATE_TASKAcciónTool to update an existing task's properties. use when you need to modify a task's details after confirming its id and new values.
TODOIST_UPDATE_TASKAcciónTool to update an existing task's properties. use when you need to modify a task's details after confirming its id and new values.
Parámetros de entrada
contentstringNew content for the task.
task_idstringObligatorioThe ID of the task to update.
due_datestringDue date in YYYY-MM-DD format.
due_langstringLanguage code for parsing `due_string`, e.g., 'en'.
priorityintegerTask priority from 1 (normal) to 4 (urgent).
label_idsinteger[]List of label IDs to assign to the task.
due_stringstringHuman-readable due date string, e.g., 'tomorrow at 12:00'.
assignee_idstringUser ID to assign the task to.
descriptionstringNew description for the task.
due_datetimestringDue date and time in RFC3339 format.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Triggers (1)
Los triggers son eventos externos que pueden iniciar un flujo en tus agentes (ej: nuevo email, mensaje recibido, registro creado).
New Task CreatedTODOIST_NEW_TASK_CREATEDTriggerTrigger when a new task is added to Todoist.
TODOIST_NEW_TASK_CREATEDTriggerTrigger when a new task is added to Todoist.
Configuración
intervalnumberPeriodic Interval to Check for Updates & Send a Trigger in Minutes
project_idstring(Optional) Filter new tasks by project ID.
Payload del evento
event_typestringType of event
taskobjectObligatorioThe Todoist task object
Instrucciones
Triggers when a new task is created in your Todoist account. If you provide a project_id, only tasks in that project will trigger the event. You can get your project ID by retrieving all projects using the Get All Projects action.