Teamwork.com
App · 30 actions
Manage your Teamwork.com work: list, create and update projects, task lists, tasks, milestones and comments, complete tasks, and log and review time.
Actions
| Action | What it does |
|---|---|
| Add task comment | Add a comment to a task. |
| Complete task | Mark a task complete. |
| Create milestone | Create a milestone in a project. |
| Create project | Create a project. |
| Create task | Create a task in a task list, optionally with a priority, dates, assignees, an estimate and tags. |
| Create task list | Create a task list in a project. |
| Delete milestone | Delete a milestone. |
| Delete project | Delete a project with its tasks, milestones and time. |
| Delete task | Delete a task. |
| Delete task list | Delete a task list and the tasks in it. |
| Delete time entry | Delete a time entry. |
| Get current user | Get the Teamwork user the API token belongs to: name, email, company and whether they are an administrator. |
| Get project | Get one project with its dates, status, company and owner. |
| Get task | Get one task with its dates, priority, assignees, tags and status. |
| Get task list | Get one task list with its project, description and status. |
| List milestones | List milestones across the site, or only in one project. |
| List people | List the people on the site, or only on one project, by name or kind. |
| List projects | List projects, filtered by name or status. |
| List tags | List the tags on the site, or only those used in one project. |
| List task comments | List the comments on a task, oldest first. |
| List task lists | List the task lists in a project. |
| List tasks | List tasks across the site, or only in one project or task list, filtered by assignee, due date or text. |
| List time entries | List logged time, newest first, across the site or only for a project or task. |
| Log time | Log time against a task for you. |
| Reopen task | Mark a completed task as not done. |
| Update milestone | Change a milestone's title, deadline, description or responsible people. |
| Update project | Change a project's name, description, dates, company or owner. |
| Update task | Change a task, including moving it to another task list. |
| Update task list | Rename a task list or change its description. |
| Update time entry | Change a time entry's day, start, duration, description or billable setting. |
Add task comment
Add a comment to a task.
Inputs
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
- Comment
bodytextRequired - The comment text.
Outputs
commentobject- The new comment
Example output
{
"comment": {
"body": "Looks good, please ship it",
"htmlBody": "<p>Looks good, please ship it</p>",
"id": 7001,
"objectId": 9001,
"objectType": "tasks",
"postedByUserId": 101,
"postedDateTime": "2026-02-21T10:00:00Z"
}
}Complete task
Mark a task complete.
Inputs
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
Outputs
taskobject- The task, now complete
Example output
{
"task": {
"assigneeUserIds": [
101
],
"completedAt": "",
"createdAt": "2026-02-20T09:10:00Z",
"description": "First draft for review",
"dueDate": "2026-03-09",
"estimateMinutes": 120,
"id": 9001,
"name": "Draft the homepage",
"parentTaskId": 0,
"priority": "high",
"progress": 100,
"startDate": "2026-03-02",
"status": "completed",
"tagIds": [
31
],
"tasklistId": 801,
"updatedAt": "2026-02-21T09:10:00Z"
}
}Create milestone
Create a milestone in a project. Without assignees, it is assigned to you.
Inputs
- Project
project_idtextRequired - The project to add the milestone to.
- Title
titletextRequired - The milestone's title.
- Deadline
deadlinedateRequired - When the milestone is due.
- Description
descriptiontext - What the milestone marks.
- Responsible
assignee_idslist - The people responsible. Defaults to you.
- Notify
notifytrue/false - Tell the responsible people about it.Default:
false. - Remind
remindertrue/false - Send a reminder before the deadline.Default:
false.
Outputs
milestoneobject- The new milestone
Example output
{
"milestone": {
"completed": false,
"createdOn": "2026-02-20T09:15:00Z",
"deadline": "2026-06-30",
"description": "Go live",
"id": 3001,
"lastChangedOn": "2026-02-21T09:15:00Z",
"name": "Launch",
"projectId": 501,
"responsiblePartyIds": [
101
]
}
}Create project
Create a project. Without a company or owner, Teamwork uses your own company and makes you the owner.
Inputs
- Name
nametextRequired - The project's name.
- Description
descriptiontext - What the project is for.
- Start date
start_datedate - When the project starts.
- End date
end_datedate - When the project ends.
- Company
company_idtext - The company the project is for.
- Owner
owner_idtext - The person who owns the project.
Outputs
projectobject- The new project
Example output
{
"project": {
"companyId": 7,
"createdAt": "2026-02-20T09:00:00Z",
"description": "Rebuild the marketing site",
"endDate": "2026-06-30",
"id": 501,
"name": "Website relaunch",
"projectOwnerId": 101,
"startDate": "2026-03-01",
"status": "active",
"subStatus": "current",
"updatedAt": "2026-02-21T09:00:00Z"
}
}Create task
Create a task in a task list, optionally with a priority, dates, assignees, an estimate and tags.
Inputs
- Task list
task_list_idtextRequired - The task list to add the task to.
- Name
nametextRequired - The task's name.
- Description
descriptiontext - What needs doing.
- Priority
prioritytext - How urgent the task is.One of:
low,medium,high. - Start date
start_datedate - When work on the task starts.
- Due date
due_datedate - When the task is due.
- Assign to
assignee_idslist - Pick people, or give ids from an earlier step.
- Estimate in minutes
estimated_minutesnumber - How long it should take.From 0 to 525600.
- Tags
tag_idslist - Pick tags, or give ids from an earlier step.
Outputs
taskobject- The new task
Example output
{
"task": {
"assigneeUserIds": [
101
],
"completedAt": "",
"createdAt": "2026-02-20T09:10:00Z",
"description": "First draft for review",
"dueDate": "2026-03-09",
"estimateMinutes": 120,
"id": 9001,
"name": "Draft the homepage",
"parentTaskId": 0,
"priority": "high",
"progress": 0,
"startDate": "2026-03-02",
"status": "new",
"tagIds": [
31
],
"tasklistId": 801,
"updatedAt": "2026-02-21T09:10:00Z"
}
}Create task list
Create a task list in a project.
Inputs
- Project
project_idtextRequired - The project to add the task list to.
- Name
nametextRequired - The task list's name.
- Description
descriptiontext - What the list is for.
- Private
is_privatetrue/false - Hide the list from client users.Default:
false.
Outputs
task_listobject- The new task list
Example output
{
"task_list": {
"createdAt": "2026-02-20T09:05:00Z",
"description": "Everything for design",
"id": 801,
"isPrivate": false,
"milestoneId": 0,
"name": "Design",
"projectId": 501,
"status": "new",
"updatedAt": "2026-02-21T09:05:00Z"
}
}Delete milestone
Delete a milestone. Its task lists and tasks stay.
Inputs
- Milestone
milestone_idtextRequired - The milestone. Pick one, or give its id from an earlier step.
Outputs
deletedtrue/false- Always true once deleted
messagetext- What was deleted
milestone_idnumber- The id of the milestone deleted
Example output
{
"deleted": true,
"message": "Milestone 3001 deleted.",
"milestone_id": 3001
}Delete project
Delete a project with its tasks, milestones and time. Check the project first: this cannot be undone from Lodol.
Inputs
- Project
project_idtextRequired - The project to delete.
Outputs
deletedtrue/false- Always true once deleted
messagetext- What was deleted
project_idnumber- The id of the project deleted
Example output
{
"deleted": true,
"message": "Project 501 deleted.",
"project_id": 501
}Delete task
Delete a task.
Inputs
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
Outputs
deletedtrue/false- Always true once deleted
messagetext- What was deleted
task_idnumber- The id of the task deleted
Example output
{
"deleted": true,
"message": "Task 9001 deleted.",
"task_id": 9001
}Delete task list
Delete a task list and the tasks in it.
Inputs
- Task list
task_list_idtextRequired - The task list to delete.
Outputs
deletedtrue/false- Always true once deleted
messagetext- What was deleted
task_list_idnumber- The id of the task list deleted
Example output
{
"deleted": true,
"message": "Task list 801 deleted.",
"task_list_id": 801
}Delete time entry
Delete a time entry.
Inputs
- Time entry ID
time_entry_idtextRequired - The time entry's id, from 'List time entries' or 'Log time'.
Outputs
deletedtrue/false- Always true once deleted
messagetext- What was deleted
time_entry_idnumber- The id of the time entry deleted
Example output
{
"deleted": true,
"message": "Time entry 6001 deleted.",
"time_entry_id": 6001
}Get current user
Get the Teamwork user the API token belongs to: name, email, company and whether they are an administrator.
Inputs
None.
Outputs
userobject- The connected user
Example output
{
"user": {
"companyId": 7,
"email": "jo@example.com",
"firstName": "Jo",
"id": 101,
"isAdmin": true,
"lastName": "Bloggs",
"type": "account"
}
}Get project
Get one project with its dates, status, company and owner.
Inputs
- Project
project_idtextRequired - The project. Pick one, or give its id from an earlier step.
Outputs
projectobject- The project
Example output
{
"project": {
"companyId": 7,
"createdAt": "2026-02-20T09:00:00Z",
"description": "Rebuild the marketing site",
"endDate": "2026-06-30",
"id": 501,
"name": "Website relaunch",
"projectOwnerId": 101,
"startDate": "2026-03-01",
"status": "active",
"subStatus": "current",
"updatedAt": "2026-02-21T09:00:00Z"
}
}Get task
Get one task with its dates, priority, assignees, tags and status.
Inputs
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
Outputs
taskobject- The task
Example output
{
"task": {
"assigneeUserIds": [
101
],
"completedAt": "",
"createdAt": "2026-02-20T09:10:00Z",
"description": "First draft for review",
"dueDate": "2026-03-09",
"estimateMinutes": 120,
"id": 9001,
"name": "Draft the homepage",
"parentTaskId": 0,
"priority": "high",
"progress": 0,
"startDate": "2026-03-02",
"status": "new",
"tagIds": [
31
],
"tasklistId": 801,
"updatedAt": "2026-02-21T09:10:00Z"
}
}Get task list
Get one task list with its project, description and status.
Inputs
- Task list
task_list_idtextRequired - The task list. Pick one, or give its id from an earlier step.
Outputs
task_listobject- The task list
Example output
{
"task_list": {
"createdAt": "2026-02-20T09:05:00Z",
"description": "Everything for design",
"id": 801,
"isPrivate": false,
"milestoneId": 0,
"name": "Design",
"projectId": 501,
"status": "new",
"updatedAt": "2026-02-21T09:05:00Z"
}
}List milestones
List milestones across the site, or only in one project. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Project
project_idtext - Only milestones in this project.
- Search
search_termtext - Only those whose name or text contains this.
- Include completed
include_completedtrue/false - Also list completed milestones.Default:
false. - Page
pagenumber - Which page to get, starting at 1.From 1 to 100000.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Outputs
countnumber- How many came back on this page
has_moretrue/false- Whether there are more pages
milestoneslist- The milestones
next_pagenumber- The page number to ask for next, or 0 when this is the last
pagenumber- The page number returned
Example output
{
"count": 1,
"has_more": false,
"milestones": [
{
"completed": false,
"createdOn": "2026-02-20T09:15:00Z",
"deadline": "2026-06-30",
"description": "Go live",
"id": 3001,
"lastChangedOn": "2026-02-21T09:15:00Z",
"name": "Launch",
"projectId": 501,
"responsiblePartyIds": [
101
]
}
],
"next_page": 0,
"page": 1
}List people
List the people on the site, or only on one project, by name or kind. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Search
search_termtext - Only those whose name or text contains this.
- Kind
user_typetext - Only this kind of person. Defaults to everyone.One of:
any(Everyone (default)),account(Team members),collaborator(Collaborators),client(Client users),contact(Contacts). Default:any. - Project
project_idtext - Only people on this project.
- Page
pagenumber - Which page to get, starting at 1.From 1 to 100000.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Outputs
countnumber- How many came back on this page
has_moretrue/false- Whether there are more pages
next_pagenumber- The page number to ask for next, or 0 when this is the last
pagenumber- The page number returned
peoplelist- The people
Example output
{
"count": 1,
"has_more": false,
"next_page": 0,
"page": 1,
"people": [
{
"companyId": 7,
"deleted": false,
"email": "jo@example.com",
"firstName": "Jo",
"id": 101,
"isAdmin": true,
"isClientUser": false,
"lastName": "Bloggs",
"title": "Project manager",
"type": "account"
}
]
}List projects
List projects, filtered by name or status. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Search
search_termtext - Only those whose name or text contains this.
- Status
project_statustext - Only projects in this state. Defaults to any.One of:
all(Any (default)),active,current,late,upcoming,completed. Default:all. - Include archived
include_archivedtrue/false - Also list archived projects.Default:
false. - Page
pagenumber - Which page to get, starting at 1.From 1 to 100000.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Outputs
countnumber- How many came back on this page
has_moretrue/false- Whether there are more pages
next_pagenumber- The page number to ask for next, or 0 when this is the last
pagenumber- The page number returned
projectslist- The projects
Example output
{
"count": 1,
"has_more": false,
"next_page": 0,
"page": 1,
"projects": [
{
"companyId": 7,
"createdAt": "2026-02-20T09:00:00Z",
"description": "Rebuild the marketing site",
"endDate": "2026-06-30",
"id": 501,
"name": "Website relaunch",
"projectOwnerId": 101,
"startDate": "2026-03-01",
"status": "active",
"subStatus": "current",
"updatedAt": "2026-02-21T09:00:00Z"
}
]
}List tags
List the tags on the site, or only those used in one project. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Search
search_termtext - Only those whose name or text contains this.
- Project
project_idtext - Only tags used in this project.
- Page
pagenumber - Which page to get, starting at 1.From 1 to 100000.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Outputs
countnumber- How many came back on this page
has_moretrue/false- Whether there are more pages
next_pagenumber- The page number to ask for next, or 0 when this is the last
pagenumber- The page number returned
tagslist- The tags
Example output
{
"count": 1,
"has_more": false,
"next_page": 0,
"page": 1,
"tags": [
{
"color": "#ff0000",
"id": 31,
"name": "Urgent",
"projectId": 0
}
]
}List task comments
List the comments on a task, oldest first. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
- Page
pagenumber - Which page to get, starting at 1.From 1 to 100000.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Outputs
commentslist- The comments
countnumber- How many came back on this page
has_moretrue/false- Whether there are more pages
next_pagenumber- The page number to ask for next, or 0 when this is the last
pagenumber- The page number returned
Example output
{
"comments": [
{
"body": "Looks good, please ship it",
"htmlBody": "<p>Looks good, please ship it</p>",
"id": 7001,
"objectId": 9001,
"objectType": "tasks",
"postedByUserId": 101,
"postedDateTime": "2026-02-21T10:00:00Z"
}
],
"count": 1,
"has_more": false,
"next_page": 0,
"page": 1
}List task lists
List the task lists in a project. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Project
project_idtextRequired - The project whose task lists to list.
- Search
search_termtext - Only those whose name or text contains this.
- Include completed
include_completedtrue/false - Also list completed task lists.Default:
false. - Page
pagenumber - Which page to get, starting at 1.From 1 to 100000.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Outputs
countnumber- How many came back on this page
has_moretrue/false- Whether there are more pages
next_pagenumber- The page number to ask for next, or 0 when this is the last
pagenumber- The page number returned
tasklistslist- The task lists
Example output
{
"count": 1,
"has_more": false,
"next_page": 0,
"page": 1,
"tasklists": [
{
"createdAt": "2026-02-20T09:05:00Z",
"description": "Everything for design",
"id": 801,
"isPrivate": false,
"milestoneId": 0,
"name": "Design",
"projectId": 501,
"status": "new",
"updatedAt": "2026-02-21T09:05:00Z"
}
]
}List tasks
List tasks across the site, or only in one project or task list, filtered by assignee, due date or text. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Project
project_idtext - Only tasks in this project.
- Task list
task_list_idtext - Only tasks in this task list.
- Assigned to
assignee_idslist - Only tasks assigned to these people.
- Search
search_termtext - Only those whose name or text contains this.
- Due
task_filtertext - Only tasks due in this window. Defaults to all.One of:
all(All (default)),overdue,today(Due today),tomorrow(Due tomorrow),thisweek(Due this week),within7(Due within 7 days),within30(Due within 30 days),noduedate(No due date),completed. Default:all. - Include completed
include_completedtrue/false - Also list completed tasks.Default:
false. - Page
pagenumber - Which page to get, starting at 1.From 1 to 100000.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Outputs
countnumber- How many came back on this page
has_moretrue/false- Whether there are more pages
next_pagenumber- The page number to ask for next, or 0 when this is the last
pagenumber- The page number returned
taskslist- The tasks
Example output
{
"count": 1,
"has_more": false,
"next_page": 0,
"page": 1,
"tasks": [
{
"assigneeUserIds": [
101
],
"completedAt": "",
"createdAt": "2026-02-20T09:10:00Z",
"description": "First draft for review",
"dueDate": "2026-03-09",
"estimateMinutes": 120,
"id": 9001,
"name": "Draft the homepage",
"parentTaskId": 0,
"priority": "high",
"progress": 0,
"startDate": "2026-03-02",
"status": "new",
"tagIds": [
31
],
"tasklistId": 801,
"updatedAt": "2026-02-21T09:10:00Z"
}
]
}List time entries
List logged time, newest first, across the site or only for a project or task. Gets one page, with the minutes on it added up; to see more, run it again with the next page it gives.
Inputs
- Project
project_idtext - Only time logged in this project.
- Task ID
task_idtext - Only time logged on this task.
- Logged by
user_idslist - Only time logged by these people.
- From
start_datedate - Only time logged on or after this day.
- Until
end_datedate - Only time logged on or before this day.
- Billable
billabletext - Only billable or only unbillable time. Defaults to all.One of:
all(All (default)),billable,nonbillable(Not billable). Default:all. - Page
pagenumber - Which page to get, starting at 1.From 1 to 100000.
- Page size
page_sizenumber - How many to return, 1 to 250. Defaults to 50.From 1 to 250.
Outputs
countnumber- How many came back on this page
has_moretrue/false- Whether there are more pages
next_pagenumber- The page number to ask for next, or 0 when this is the last
pagenumber- The page number returned
timelogslist- The time entries
total_minutesnumber- Minutes added up across this page
Example output
{
"count": 1,
"has_more": false,
"next_page": 0,
"page": 1,
"timelogs": [
{
"createdAt": "2026-03-02T11:00:00Z",
"description": "Homepage draft",
"id": 6001,
"isBillable": true,
"minutes": 90,
"projectId": 501,
"taskId": 9001,
"timeLogged": "2026-03-02T09:00:00Z",
"updatedAt": "2026-03-02T11:00:00Z",
"userId": 101
}
],
"total_minutes": 90
}Log time
Log time against a task for you. Give hours, minutes or both; they are added together.
Inputs
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
- Date
datedateRequired - The day the work was done.
- Hours
hoursnumber - Hours spent. Decimals work, such as 1.5.From 0 to 1000.
- Minutes
minutesnumber - Extra minutes spent.From 0 to 59940.
- Started at
start_timetime - The time of day the work started. Leave empty to log only the amount.
- Description
descriptiontext - What the time was spent on.
- Billable
is_billabletrue/false - Whether the time can be billed. Leave off to use the project's setting.Default:
false.
Outputs
time_entryobject- The new time entry
Example output
{
"time_entry": {
"createdAt": "2026-03-02T11:00:00Z",
"description": "Homepage draft",
"id": 6001,
"isBillable": true,
"minutes": 90,
"projectId": 501,
"taskId": 9001,
"timeLogged": "2026-03-02T09:00:00Z",
"updatedAt": "2026-03-02T11:00:00Z",
"userId": 101
}
}Reopen task
Mark a completed task as not done.
Inputs
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
Outputs
taskobject- The task, now open again
Example output
{
"task": {
"assigneeUserIds": [
101
],
"completedAt": "",
"createdAt": "2026-02-20T09:10:00Z",
"description": "First draft for review",
"dueDate": "2026-03-09",
"estimateMinutes": 120,
"id": 9001,
"name": "Draft the homepage",
"parentTaskId": 0,
"priority": "high",
"progress": 0,
"startDate": "2026-03-02",
"status": "reopened",
"tagIds": [
31
],
"tasklistId": 801,
"updatedAt": "2026-02-21T09:10:00Z"
}
}Update milestone
Change a milestone's title, deadline, description or responsible people. Fields left empty stay as they are.
Inputs
- Milestone
milestone_idtextRequired - The milestone. Pick one, or give its id from an earlier step.
- Title
titletext - A new title. Leave empty to keep it.
- Deadline
deadlinedate - A new deadline.
- Description
descriptiontext - A new description. Leave empty to keep it.
- Responsible
assignee_idslist - Replace the people responsible.
Outputs
milestoneobject- The milestone after the change
Example output
{
"milestone": {
"completed": false,
"createdOn": "2026-02-20T09:15:00Z",
"deadline": "2026-06-30",
"description": "Go live",
"id": 3001,
"lastChangedOn": "2026-02-21T09:15:00Z",
"name": "Launch",
"projectId": 501,
"responsiblePartyIds": [
101
]
}
}Update project
Change a project's name, description, dates, company or owner. Fields left empty stay as they are.
Inputs
- Project
project_idtextRequired - The project to change.
- Name
nametext - A new name. Leave empty to keep it.
- Description
descriptiontext - What the project is for.
- Start date
start_datedate - When the project starts.
- End date
end_datedate - When the project ends.
- Company
company_idtext - The company the project is for.
- Owner
owner_idtext - The person who owns the project.
Outputs
projectobject- The project after the change
Example output
{
"project": {
"companyId": 7,
"createdAt": "2026-02-20T09:00:00Z",
"description": "Rebuild the marketing site",
"endDate": "2026-06-30",
"id": 501,
"name": "Website relaunch",
"projectOwnerId": 101,
"startDate": "2026-03-01",
"status": "active",
"subStatus": "current",
"updatedAt": "2026-02-21T09:00:00Z"
}
}Update task
Change a task, including moving it to another task list. Fields left empty stay as they are.
Inputs
- Task ID
task_idtextRequired - The task's id, from 'List tasks' or an earlier step.
- Name
nametext - A new name. Leave empty to keep it.
- Description
descriptiontext - What needs doing.
- Priority
prioritytext - How urgent the task is.One of:
low,medium,high. - Start date
start_datedate - When work on the task starts.
- Due date
due_datedate - When the task is due.
- Assign to
assignee_idslist - Pick people, or give ids from an earlier step.
- Estimate in minutes
estimated_minutesnumber - How long it should take.From 0 to 525600.
- Tags
tag_idslist - Pick tags, or give ids from an earlier step.
- Task list
task_list_idtext - Move the task to this task list.
Outputs
taskobject- The task after the change
Example output
{
"task": {
"assigneeUserIds": [
101
],
"completedAt": "",
"createdAt": "2026-02-20T09:10:00Z",
"description": "First draft for review",
"dueDate": "2026-03-09",
"estimateMinutes": 120,
"id": 9001,
"name": "Draft the homepage",
"parentTaskId": 0,
"priority": "high",
"progress": 0,
"startDate": "2026-03-02",
"status": "new",
"tagIds": [
31
],
"tasklistId": 801,
"updatedAt": "2026-02-21T09:10:00Z"
}
}Update task list
Rename a task list or change its description. Fields left empty stay as they are.
Inputs
- Task list
task_list_idtextRequired - The task list to change.
- Name
nametext - A new name. Leave empty to keep it.
- Description
descriptiontext - A new description. Leave empty to keep it.
Outputs
task_listobject- The task list after the change
Example output
{
"task_list": {
"createdAt": "2026-02-20T09:05:00Z",
"description": "Everything for design",
"id": 801,
"isPrivate": false,
"milestoneId": 0,
"name": "Design",
"projectId": 501,
"status": "new",
"updatedAt": "2026-02-21T09:05:00Z"
}
}Update time entry
Change a time entry's day, start, duration, description or billable setting. Fields left empty stay as they are.
Inputs
- Time entry ID
time_entry_idtextRequired - The time entry's id, from 'List time entries' or 'Log time'.
- Date
datedate - A new day for the work.
- Hours
hoursnumber - Hours spent. Decimals work, such as 1.5.From 0 to 1000.
- Minutes
minutesnumber - Extra minutes spent.From 0 to 59940.
- Started at
start_timetime - The time of day the work started. Leave empty to log only the amount.
- Description
descriptiontext - What the time was spent on.
- Billable
is_billabletrue/false - Whether the time can be billed. Leave off to use the project's setting.Default:
false.
Outputs
time_entryobject- The time entry after the change
Example output
{
"time_entry": {
"createdAt": "2026-03-02T11:00:00Z",
"description": "Homepage draft",
"id": 6001,
"isBillable": true,
"minutes": 90,
"projectId": 501,
"taskId": 9001,
"timeLogged": "2026-03-02T09:00:00Z",
"updatedAt": "2026-03-02T11:00:00Z",
"userId": 101
}
}