v1

latestOpenAPI 3.0.02026-08-061478520.6 KB

[v1] Task

Create new task

Create new task. To ceate new task you should have proper permissions.

post/tasks

Request body

namestring required

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

task budget value, defined in the unit specified by budget_unit

notestring

description for task

archivedinteger

is task archived

billable0 | 1

is task billable

budget_unit'hours' | 'fee'

budget unit: hours, fee or empty

user_idsstring

comma separated user ids to add to task

roleinteger

works only if user_ids are provided - sets given role to given user_ids in created task

keywordsstring

comma separated keywords

Example request

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

Response

Created