Create task
Create a task: title plus optional description, workspace task workflow status (defaults to the entry column), ISO-8601 due date, attached post (contentItemId), assignees, and registry tags. Assignees must be team members and tags must belong to the team - foreign ids are silently ignored. Never spends credits.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.
Body
Short imperative title for the task, 1-500 characters.
1 - 500Plain-text description used for search, card excerpts, and previews. Up to 10,000 characters.
10000Rich (block-based) description document, stored verbatim for the task editor. Send null to clear it. Keep the plain-text description field in sync for search and previews.
Workspace-owned task workflow status id. Omit on create to use the first not_started task status.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Legacy task-state projection retained for checklist and summary compatibility. The workspace workflow status is authoritative.
todo, in_progress, done ISO-8601 instant the task is due. Send null to clear the due date; tasks with a due date also appear on the calendar.
Id of the post this task is attached to (its checklist), as returned by the list posts endpoint. Send null to detach; attached tasks are removed with their post.
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Full replacement set of team-member user ids assigned to the task; an empty array clears every assignment. Non-members are silently ignored.
a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Full replacement set of registry tag ids on the task (same registry as post tags); an empty array clears them. Tags from other teams are silently ignored.
a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$Response
Success
a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$todo, in_progress, done a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$a Universally Unique Identifier
^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$