tasks

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

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.

post/api/v1/pm/tasks

Request

Base URL
https://api.simplified.com
Auth
API key in header Authorization

Headers

Organizationstring

Workspace (organization) ID the request is scoped to.

Spacestring

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

Request body

statusstring uuid required

Target status UUID.

titlestring

descriptionstring

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_descriptionobject

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_datestring date-time

due_datestring date-time

priorityinteger

Priority enum value.

parentstring uuid

Parent task UUID (for subtasks).

task_type'TASK' | 'SUBTASK' | 'CHECKLIST' | 'TEMPLATE'

Task discriminator. Defaults to TASK.

completeboolean

estimated_hoursnumber double

Estimated completion time in hours.

orderinteger

extraobject

Free-form payload (_extra on the model).

custom_fieldsobject

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

tagsstring[]

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

assigneesinteger[]

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.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.