Ticktick

ticktick

TickTick is a cross-platform task management and to-do list application designed to help users organize their tasks and schedules efficiently.

Productivity Task Management Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Sí

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (13)

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.

Complete TaskTICKTICK_COMPLETE_TASKAcción

Tool to mark a task as complete. use after confirming the task is done.

Parámetros de entrada

task_idstringObligatorio
Identifier of the task to mark as complete.
project_idstringObligatorio
Project identifier containing the task to complete.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create TaskTICKTICK_CREATE_TASKAcción

Tool to create a new task in ticktick. use after you have task details such as title, dates, and optional reminders or subtasks.

Parámetros de entrada

descstring
Extended description of the task
itemsobject[]
Checklist (subtask) items
titlestringObligatorio
Title of the task
contentstring
Main content or notes of the task
dueDatestring
ISO 8601 due date/time, e.g., '2023-04-24T17:00:00+0000'
isAllDayboolean
Set true for an all-day task
priorityinteger
Task priority (0=None, 1=Low, 3=Medium, 5=High)
timeZonestring
Time zone identifier, e.g., 'America/Los_Angeles'
projectIdstring
ID of the project (list) to add the task to
remindersstring[]
List of reminder triggers in RFC 5545 format, e.g., ['TRIGGER:PT10M', 'TRIGGER:PT0S']
sortOrderinteger
Internal sort index
startDatestring
ISO 8601 start date/time, e.g., '2023-04-23T12:00:00+0000'
repeatFlagstring
RRULE string for recurrence, e.g., 'RRULE:FREQ=DAILY;INTERVAL=1'

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete TaskTICKTICK_DELETE_TASKAcción

Tool to delete a specific task. use when you need to remove a task from a project after confirming both project and task ids.

Parámetros de entrada

task_idstringObligatorio
Task identifier to delete.
project_idstringObligatorio
Project identifier containing the task to delete.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get User ProjectsTICKTICK_GET_USER_PROJECTAcción

Tool to retrieve all projects for the user. use when you need to list available projects for selection.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Complete TaskTICKTICK_TICKTICK_COMPLETE_TASKAcción

Tool to mark a specific task as complete. use after confirming the task is done.

Parámetros de entrada

task_idstringObligatorio
Task identifier to mark complete.
project_idstringObligatorio
Project identifier containing the task to complete.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create ProjectTICKTICK_TICKTICK_CREATE_PROJECTAcción

Tool to create a new project in ticktick. use when you need to programmatically add a project after obtaining a valid access token.

Parámetros de entrada

kindstringenum
Optional project kind
TASKNOTE
namestringObligatorio
Name of the new project
colorstring
Hex color code for the project, e.g., '#F18181'
viewModestringenum
Optional view mode for the project
listkanbantimeline
sortOrderinteger
Optional sort order value of the project

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete TickTick ProjectTICKTICK_TICKTICK_DELETE_PROJECTAcción

Tool to delete a specific project. use when you have confirmed the project id and intend to permanently remove it. example: "delete the project with id 6226ff9877acee87727f6bca".

Parámetros de entrada

project_idstringObligatorio
Project identifier to delete

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get project with dataTICKTICK_TICKTICK_GET_PROJECT_WITH_DATAAcción

Tool to retrieve a project and its associated data (tasks, columns). use when you need full project details including its tasks and columns after selecting a project id.

Parámetros de entrada

projectIdstringObligatorio
Project identifier to retrieve data for

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Generate OAuth2 Authorization URLTICKTICK_TICKTICK_OAUTH2_AUTHORIZATION_STEP1Acción

Tool to generate the ticktick oauth2 authorization url. use to redirect the user to obtain the authorization code (step 1).

Parámetros de entrada

scopestringObligatorio
Space-separated permission scopes. Available scopes: 'tasks:read', 'tasks:write'.
statestring
An opaque value passed back to your redirect URI for CSRF protection and to maintain request state (optional).
client_idstringObligatorio
Your TickTick application's client ID obtained from the Developer Center.
redirect_uristringObligatorio
The exact redirect URI registered with your TickTick application; the authorization code will be sent here after user approval.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Redirect to TickTick OAuth2 authorization pageTICKTICK_TICKTICK_OAUTH2_AUTHORIZATION_STEP_1Acción

Tool to redirect user to ticktick authorization page to obtain authorization code. use when initiating the oauth2 flow before exchanging the code.

Parámetros de entrada

scopestringObligatorio
Space-separated permission scopes. Available scopes: 'tasks:read', 'tasks:write'.
statestring
An opaque value passed back to your redirect URI for CSRF protection and to maintain request state.
client_idstringObligatorio
Your TickTick application's client ID obtained from the Developer Center.
redirect_urianyObligatoriouri
The exact redirect URI registered with your TickTick application; the authorization code will be sent here.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update ProjectTICKTICK_TICKTICK_UPDATE_PROJECTAcción

Tool to update an existing project. use when you need to modify project details like name, color, sort order, view mode, or kind after selecting a project id.

Parámetros de entrada

kindstringenum
Kind of the project, 'TASK' or 'NOTE'
TASKNOTE
namestring
New name of the project
colorstring
Hex color code for the project, e.g. '#F18181'
viewModestringenum
View mode of the project
listkanbantimeline
projectIdstringObligatorio
Project identifier to update
sortOrderinteger
Sort order value of the project

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update ProjectTICKTICK_UPDATE_PROJECTAcción

Tool to update an existing project. use when you need to modify project details like name, color, sort order, view mode, or kind after selecting a project id.

Parámetros de entrada

kindstringenum
Kind of the project, 'TASK' or 'NOTE'
TASKNOTE
namestring
New name of the project
colorstring
Hex color code for the project, e.g. '#F18181'
viewModestringenum
View mode for the project
listkanbantimeline
projectIdstringObligatorio
Project identifier to update
sortOrderinteger
Sort order value of the project

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update TaskTICKTICK_UPDATE_TASKAcción

Tool to update an existing task. use after confirming the taskid and projectid.

Parámetros de entrada

descstring
Extended description of the task
itemsobject[]
Checklist (subtask) items
titlestring
New title of the task
taskIdstringObligatorio
Task identifier to update
contentstring
Content or notes of the task
dueDatestring
ISO 8601 due date/time, e.g., '2023-04-24T17:00:00+0000'
isAllDayboolean
Set true for an all-day task
priorityinteger
Task priority (0=None, 1=Low, 3=Medium, 5=High)
timeZonestring
Time zone identifier, e.g., 'America/Los_Angeles'
projectIdstringObligatorio
Project identifier containing the task
remindersstring[]
List of reminder triggers in RFC 5545 format, e.g., ['TRIGGER:PT10M']
sortOrderinteger
Internal sort index for ordering tasks
startDatestring
ISO 8601 start date/time, e.g., '2023-04-23T12:00:00+0000'
repeatFlagstring
RRULE string for recurrence, e.g., 'RRULE:FREQ=DAILY;INTERVAL=1'

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not