← Tools Reference

TickTick

TickTick integration (Productivity). Imported from open-connector.

OAuth19 toolshttps://api.ticktick.com
GET
ticktick_get_user_project
List the projects available to the connected TickTick account.

/open/v1/project

GET
ticktick_get_project_by_id
Get a TickTick project by its project ID.

/open/v1/project/{projectId}

1 parameter
ParamTypeRequiredDescription
projectIdstringrequiredThe TickTick project ID.
GET
ticktick_get_project_with_data
Get a TickTick project together with its undone tasks and columns.

/open/v1/project/{projectId}/data

1 parameter
ParamTypeRequiredDescription
projectIdstringrequiredThe TickTick project ID.
POST
ticktick_create_project
Create a TickTick project.

/open/v1/project

6 parameters
ParamTypeRequiredDescription
projectIdstringoptionalThe TickTick project ID.
namestringrequiredThe TickTick project name.
colorstringoptionalThe TickTick project color.
sortOrderintegeroptionalThe TickTick project sort order.
viewModestringoptionalThe TickTick project view mode.
kindstringoptionalThe TickTick project kind.
POST
ticktick_update_project
Update a TickTick project by project ID.

/open/v1/project/{projectId}

6 parameters
ParamTypeRequiredDescription
projectIdstringrequiredThe TickTick project ID.
namestringoptionalThe TickTick project name.
colorstringoptionalThe TickTick project color.
sortOrderintegeroptionalThe TickTick project sort order.
viewModestringoptionalThe TickTick project view mode.
kindstringoptionalThe TickTick project kind.
DELETE
ticktick_delete_project
Delete a TickTick project by project ID.

/open/v1/project/{projectId}

1 parameter
ParamTypeRequiredDescription
projectIdstringrequiredThe TickTick project ID.
GET
ticktick_get_task_by_project_and_id
Get a TickTick task by project ID and task ID.

/open/v1/project/{projectId}/task/{taskId}

2 parameters
ParamTypeRequiredDescription
projectIdstringrequiredThe TickTick project ID.
taskIdstringrequiredThe TickTick task ID.
POST
ticktick_create_task
Create a TickTick task under a project.

/open/v1/task

13 parameters
ParamTypeRequiredDescription
projectIdstringrequiredThe TickTick project ID.
titlestringrequiredThe TickTick task title.
contentstringoptionalThe TickTick task content.
descstringoptionalThe TickTick task description.
isAllDaybooleanoptionalWhether the task is all day.
startDatestringoptionalThe TickTick date-time string in yyyy-MM-dd'T'HH:mm:ssZ format.
dueDatestringoptionalThe TickTick date-time string in yyyy-MM-dd'T'HH:mm:ssZ format.
timeZonestringoptionalThe TickTick task time zone.
remindersarrayoptionalTickTick reminder trigger strings.
repeatFlagstringoptionalThe TickTick recurrence rule.
prioritynumberoptionalThe TickTick priority value.
sortOrderintegeroptionalThe TickTick task sort order.
itemsarrayoptionalChecklist items to create under the task.
POST
ticktick_update_task
Update a TickTick task by task ID and project ID.

/open/v1/task/{taskId}

15 parameters
ParamTypeRequiredDescription
taskIdstringrequiredThe TickTick task ID.
idstringoptionalOptional task ID repeated in the request body.
projectIdstringrequiredThe TickTick project ID.
titlestringoptionalThe TickTick task title.
contentstringoptionalThe TickTick task content.
descstringoptionalThe TickTick task description.
isAllDaybooleanoptionalWhether the task is all day.
startDatestringoptionalThe TickTick date-time string in yyyy-MM-dd'T'HH:mm:ssZ format.
dueDatestringoptionalThe TickTick date-time string in yyyy-MM-dd'T'HH:mm:ssZ format.
timeZonestringoptionalThe TickTick task time zone.
remindersarrayoptionalTickTick reminder trigger strings.
repeatFlagstringoptionalThe TickTick recurrence rule.
prioritynumberoptionalThe TickTick priority value.
sortOrderintegeroptionalThe TickTick task sort order.
itemsarrayoptionalChecklist items to create under the task.
POST
ticktick_complete_task
Mark a TickTick task as completed.

/open/v1/project/{projectId}/task/{taskId}/complete

2 parameters
ParamTypeRequiredDescription
projectIdstringrequiredThe TickTick project ID.
taskIdstringrequiredThe TickTick task ID.
DELETE
ticktick_delete_task
Delete a TickTick task by project ID and task ID.

/open/v1/project/{projectId}/task/{taskId}

2 parameters
ParamTypeRequiredDescription
projectIdstringrequiredThe TickTick project ID.
taskIdstringrequiredThe TickTick task ID.
GET
ticktick_list_all_tasks
List undone TickTick tasks across projects.

/open/v1/project/{projectId}/data

4 parameters
ParamTypeRequiredDescription
limitintegeroptionalThe maximum number of tasks to return.
projectIdsarrayoptionalProject IDs to include.
includeClosedProjectsbooleanoptionalWhether closed projects should be included.
projectIdstringrequiredPath parameter: projectId
POST
ticktick_list_completed_tasks
List completed TickTick tasks.

/open/v1/task/completed

3 parameters
ParamTypeRequiredDescription
projectIdsarrayoptionalProject IDs to filter by.
startDatestringoptionalThe TickTick date-time string in yyyy-MM-dd'T'HH:mm:ssZ format.
endDatestringoptionalThe TickTick date-time string in yyyy-MM-dd'T'HH:mm:ssZ format.
POST
ticktick_filter_tasks
Filter TickTick tasks by project, date range, priority, tags, and status.

/open/v1/task/filter

6 parameters
ParamTypeRequiredDescription
projectIdsarrayoptionalProject IDs to filter by.
startDatestringoptionalThe TickTick date-time string in yyyy-MM-dd'T'HH:mm:ssZ format.
endDatestringoptionalThe TickTick date-time string in yyyy-MM-dd'T'HH:mm:ssZ format.
priorityarrayoptionalPriority values to filter by.
tagarrayoptionalTags to filter by.
statusarrayoptionalTask status codes to filter by.
POST
ticktick_move_tasks
Move one or more TickTick tasks between projects.

/open/v1/task/move

1 parameter
ParamTypeRequiredDescription
movesarrayoptionalThe TickTick task move operations.
GET
ticktick_list_habits
List habits available to the connected TickTick account.

/open/v1/habit

GET
ticktick_get_habit
Get a TickTick habit by its habit ID.

/open/v1/habit/{habitId}

1 parameter
ParamTypeRequiredDescription
habitIdstringrequiredThe TickTick habit ID.
POST
ticktick_create_or_update_habit_checkin
Create or update a TickTick habit check-in for a date stamp.

/open/v1/habit/{habitId}/checkin

7 parameters
ParamTypeRequiredDescription
habitIdstringrequiredThe TickTick habit ID.
stampintegerrequiredA date stamp in YYYYMMDD format.
timestringoptionalThe TickTick date-time string in yyyy-MM-dd'T'HH:mm:ssZ format.
opTimestringoptionalThe TickTick date-time string in yyyy-MM-dd'T'HH:mm:ssZ format.
valuenumberoptionalThe check-in value.
goalnumberoptionalThe check-in goal.
statusintegeroptionalThe check-in status.
GET
ticktick_list_habit_checkins
List TickTick habit check-ins over a date stamp range.

/open/v1/habit/checkins

3 parameters
ParamTypeRequiredDescription
habitIdsarrayoptionalThe TickTick habit IDs to query.
fromintegeroptionalStart date stamp in YYYYMMDD format.
tointegeroptionalEnd date stamp in YYYYMMDD format.