Sign in

v1

latestOpenAPI 3.0.02026-08-061478520.6 KB
[v1] Task

Update task info

Modify existing task. To modify a task you should have proper permissions.

put/tasks

Request body

namestring

new task name

tagsstring

comma separated tags' names

external_task_idstring

external task id ie. id of task in other system/integration

external_parent_idstring

external parent id ie. id of parent task in other system/integration

budgetedinteger

Deprecated — use PATCH /v3/task/{taskId}/billing-settings with budget field instead. Task budget value, defined in the unit specified by budget_unit.

notestring

description for task

archived0 | 1

is task archived

billable0 | 1

Deprecated — use PATCH /v3/task/{taskId}/billing-settings with billable field instead. Is task billable.

budget_unit'hours' | 'fee'

Deprecated — use PATCH /v3/task/{taskId}/billing-settings with budgetUnit field instead. Budget unit: hours, fee or empty.

user_idsstring

comma separated user ids to update role in task

roleinteger

works only if user_ids are provided - updates role foruser_ids

keywordsstring

comma separated keywords

Example request

{
  "name": "SomeNewTaskName",
  "tags": "IT,R&D",
  "external_task_id": "xero_g8g89s78ds8",
  "external_parent_id": "xero_2b5b26tb295bb9",
  "budgeted": 1000,
  "note": "SomeNewNote",
  "user_ids": "22,521,2,25",
  "role": 5215,
  "keywords": "IT,R&D"
}

Response

OK

namestring
add_datestring
colorstring
tagsstring
checked_datestring nullable
due_datestring nullable
notestring nullable
contextstring nullable
folderstring nullable
repeatstring nullable
budget_unitstring

Deprecated — use GET /v3/task/{taskId}/billing-settings (budgetUnit field) instead.

public_hashstring nullable
modify_timestring
keywordsstring