Sign in

v1

latestOpenAPI 3.1.02026-07-24770322.0 KB

Create Task

This API endpoint creates a task.

post/v1/tasks

Request body

namestring

The name of the task.

descriptionstring

The description of the task.

parentTaskIdstring

The parent task of the task, if task should be a subtask.

statusstring

The status of the task, one of todo/inProgress/completed.

internalUserIdstring

The uuid of the internal user assigned to this task.

clientIdstring

The uuid of the client user assigned to this task. Company ID field is required if this field is used.

companyIdstring

The uuid of the company assigned to this task. If assigning to a client user, this field is required as well.

dueDatestring

The date the task is due, in RFC3339 format.

templateIdstring

ID of the template to use when creating this task

Response

200

archivedBystring
archivedDatestring
clientIdstring
companyIdstring
completedBystring
completedByUserTypestring
completedDatestring
createdBystring
createdDatestring
creatorTypestring
deletedBystring
deletedDatestring
descriptionstring
dueDatestring
idstring
isArchivedboolean
isDeletedboolean
labelstring
namestring
objectstring
parentTaskIdstring
sourcestring
statusstring
templateIdstring
attachmentsobject[]

Example response

{
  "clientId": "aead02ad-bd03-4956-8177-7bd8a24b99e4",
  "companyId": "fadf235-af2d-afdaa-adfw-fadfadfar23f",
  "createdBy": "27024189-ea18-40a7-a5cf-48579c352dee",
  "createdDate": "2025-05-06T13:24:22Z",
  "creatorType": "internalUser",
  "description": "<p>Bow before me mortals</p>",
  "id": "b941c6ab-9cac-4fb2-9a11-8830396e3f2e",
  "label": "TES-089",
  "name": "Task name",
  "object": "task",
  "parentTaskId": "9fccce1a-644b-4331-9741-113d504e7dee",
  "source": "api",
  "status": "todo"
}