Skip to navigation
Project ManagerTasks

PM · Tasks · Create a task in a status column with inline assignees and tags

View as Markdown

Create a task in a status column. The status UUID is required and determines which board the task belongs to. Composite fields (assignees, tags) are handled by the toolkit’s middleware — pass them inline and the correct sub-resource calls are made automatically after creation. Note: assignees are NOT reflected in the create response; use getTask?expand=assignees to verify.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

OrganizationstringOptional

Workspace (organization) ID the request is scoped to.

SpacestringOptional

Optional sub-space ID for further scoping inside the workspace.

Request

This endpoint expects an object.
statusstringRequiredformat: "uuid"
Target status UUID.
titlestringOptional<=2048 characters
descriptionstringOptional

Plain text task description. This is the field agents and CLI users should set. The toolkit converts it to a Quill Delta and writes rich_description automatically.

rich_descriptionmap from strings to anyOptional

INTERNAL — Quill Delta representation. Set automatically by the toolkit when you pass description. Do not pass directly unless you have a pre-built Delta and know what you're doing.

start_datedatetimeOptional
due_datedatetimeOptional
priorityintegerOptional
Priority enum value.
parentstringOptionalformat: "uuid"

Parent task UUID (for subtasks).

task_typeenumOptional

Task discriminator. Defaults to TASK.

Allowed values:
completebooleanOptional
estimated_hoursdoubleOptional
Estimated completion time in hours.
orderintegerOptional
extramap from strings to anyOptional

Free-form payload (_extra on the model).

custom_fieldsmap from strings to anyOptional

Map of custom field UUID → value. Validated against board's custom-field configuration.

tagslist of stringsOptional

Tag names to apply to the task on creation (native — set in one call).

assigneeslist of integersOptional

Integer user IDs to assign (get from listWorkspaceMembers). Composite field — toolkit calls POST /tasks/{id}/assignees/ automatically after creation. Note: assignees are NOT in the createTask response; use getTask?expand=assignees to verify.

Response

Task created.