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

ActionWhat it does
Add task commentAdd a comment to a task.
Complete taskMark a task complete.
Create milestoneCreate a milestone in a project.
Create projectCreate a project.
Create taskCreate a task in a task list, optionally with a priority, dates, assignees, an estimate and tags.
Create task listCreate a task list in a project.
Delete milestoneDelete a milestone.
Delete projectDelete a project with its tasks, milestones and time.
Delete taskDelete a task.
Delete task listDelete a task list and the tasks in it.
Delete time entryDelete a time entry.
Get current userGet the Teamwork user the API token belongs to: name, email, company and whether they are an administrator.
Get projectGet one project with its dates, status, company and owner.
Get taskGet one task with its dates, priority, assignees, tags and status.
Get task listGet one task list with its project, description and status.
List milestonesList milestones across the site, or only in one project.
List peopleList the people on the site, or only on one project, by name or kind.
List projectsList projects, filtered by name or status.
List tagsList the tags on the site, or only those used in one project.
List task commentsList the comments on a task, oldest first.
List task listsList the task lists in a project.
List tasksList tasks across the site, or only in one project or task list, filtered by assignee, due date or text.
List time entriesList logged time, newest first, across the site or only for a project or task.
Log timeLog time against a task for you.
Reopen taskMark a completed task as not done.
Update milestoneChange a milestone's title, deadline, description or responsible people.
Update projectChange a project's name, description, dates, company or owner.
Update taskChange a task, including moving it to another task list.
Update task listRename a task list or change its description.
Update time entryChange a time entry's day, start, duration, description or billable setting.

Add task comment

Add a comment to a task.

Inputs

Task IDtask_idtextRequired
The task's id, from 'List tasks' or an earlier step.
CommentbodytextRequired
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 IDtask_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

Projectproject_idtextRequired
The project to add the milestone to.
TitletitletextRequired
The milestone's title.
DeadlinedeadlinedateRequired
When the milestone is due.
Descriptiondescriptiontext
What the milestone marks.
Responsibleassignee_idslist
The people responsible. Defaults to you.
Notifynotifytrue/false
Tell the responsible people about it.Default: false.
Remindremindertrue/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

NamenametextRequired
The project's name.
Descriptiondescriptiontext
What the project is for.
Start datestart_datedate
When the project starts.
End dateend_datedate
When the project ends.
Companycompany_idtext
The company the project is for.
Ownerowner_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 listtask_list_idtextRequired
The task list to add the task to.
NamenametextRequired
The task's name.
Descriptiondescriptiontext
What needs doing.
Priorityprioritytext
How urgent the task is.One of: low, medium, high.
Start datestart_datedate
When work on the task starts.
Due datedue_datedate
When the task is due.
Assign toassignee_idslist
Pick people, or give ids from an earlier step.
Estimate in minutesestimated_minutesnumber
How long it should take.From 0 to 525600.
Tagstag_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

Projectproject_idtextRequired
The project to add the task list to.
NamenametextRequired
The task list's name.
Descriptiondescriptiontext
What the list is for.
Privateis_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

Milestonemilestone_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

Projectproject_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 IDtask_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 listtask_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 IDtime_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

Projectproject_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 IDtask_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 listtask_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

Projectproject_idtext
Only milestones in this project.
Searchsearch_termtext
Only those whose name or text contains this.
Include completedinclude_completedtrue/false
Also list completed milestones.Default: false.
Pagepagenumber
Which page to get, starting at 1.From 1 to 100000.
Page sizepage_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

Searchsearch_termtext
Only those whose name or text contains this.
Kinduser_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.
Projectproject_idtext
Only people on this project.
Pagepagenumber
Which page to get, starting at 1.From 1 to 100000.
Page sizepage_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

Searchsearch_termtext
Only those whose name or text contains this.
Statusproject_statustext
Only projects in this state. Defaults to any.One of: all (Any (default)), active, current, late, upcoming, completed. Default: all.
Include archivedinclude_archivedtrue/false
Also list archived projects.Default: false.
Pagepagenumber
Which page to get, starting at 1.From 1 to 100000.
Page sizepage_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

Searchsearch_termtext
Only those whose name or text contains this.
Projectproject_idtext
Only tags used in this project.
Pagepagenumber
Which page to get, starting at 1.From 1 to 100000.
Page sizepage_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 IDtask_idtextRequired
The task's id, from 'List tasks' or an earlier step.
Pagepagenumber
Which page to get, starting at 1.From 1 to 100000.
Page sizepage_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

Projectproject_idtextRequired
The project whose task lists to list.
Searchsearch_termtext
Only those whose name or text contains this.
Include completedinclude_completedtrue/false
Also list completed task lists.Default: false.
Pagepagenumber
Which page to get, starting at 1.From 1 to 100000.
Page sizepage_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

Projectproject_idtext
Only tasks in this project.
Task listtask_list_idtext
Only tasks in this task list.
Assigned toassignee_idslist
Only tasks assigned to these people.
Searchsearch_termtext
Only those whose name or text contains this.
Duetask_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 completedinclude_completedtrue/false
Also list completed tasks.Default: false.
Pagepagenumber
Which page to get, starting at 1.From 1 to 100000.
Page sizepage_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

Projectproject_idtext
Only time logged in this project.
Task IDtask_idtext
Only time logged on this task.
Logged byuser_idslist
Only time logged by these people.
Fromstart_datedate
Only time logged on or after this day.
Untilend_datedate
Only time logged on or before this day.
Billablebillabletext
Only billable or only unbillable time. Defaults to all.One of: all (All (default)), billable, nonbillable (Not billable). Default: all.
Pagepagenumber
Which page to get, starting at 1.From 1 to 100000.
Page sizepage_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 IDtask_idtextRequired
The task's id, from 'List tasks' or an earlier step.
DatedatedateRequired
The day the work was done.
Hourshoursnumber
Hours spent. Decimals work, such as 1.5.From 0 to 1000.
Minutesminutesnumber
Extra minutes spent.From 0 to 59940.
Started atstart_timetime
The time of day the work started. Leave empty to log only the amount.
Descriptiondescriptiontext
What the time was spent on.
Billableis_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 IDtask_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

Milestonemilestone_idtextRequired
The milestone. Pick one, or give its id from an earlier step.
Titletitletext
A new title. Leave empty to keep it.
Deadlinedeadlinedate
A new deadline.
Descriptiondescriptiontext
A new description. Leave empty to keep it.
Responsibleassignee_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

Projectproject_idtextRequired
The project to change.
Namenametext
A new name. Leave empty to keep it.
Descriptiondescriptiontext
What the project is for.
Start datestart_datedate
When the project starts.
End dateend_datedate
When the project ends.
Companycompany_idtext
The company the project is for.
Ownerowner_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 IDtask_idtextRequired
The task's id, from 'List tasks' or an earlier step.
Namenametext
A new name. Leave empty to keep it.
Descriptiondescriptiontext
What needs doing.
Priorityprioritytext
How urgent the task is.One of: low, medium, high.
Start datestart_datedate
When work on the task starts.
Due datedue_datedate
When the task is due.
Assign toassignee_idslist
Pick people, or give ids from an earlier step.
Estimate in minutesestimated_minutesnumber
How long it should take.From 0 to 525600.
Tagstag_idslist
Pick tags, or give ids from an earlier step.
Task listtask_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 listtask_list_idtextRequired
The task list to change.
Namenametext
A new name. Leave empty to keep it.
Descriptiondescriptiontext
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 IDtime_entry_idtextRequired
The time entry's id, from 'List time entries' or 'Log time'.
Datedatedate
A new day for the work.
Hourshoursnumber
Hours spent. Decimals work, such as 1.5.From 0 to 1000.
Minutesminutesnumber
Extra minutes spent.From 0 to 59940.
Started atstart_timetime
The time of day the work started. Leave empty to log only the amount.
Descriptiondescriptiontext
What the time was spent on.
Billableis_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
  }
}

On this page