/v1/tasksCreate a task
Raises a task: title, an optional description, dueAt (RFC3339), priority, assigneeAccountId (the roster's account id), tags, and entityRef "/" to file it on a record. A task with a due TIME also lands on the assignee's calendar when their preferences mirror tasks. To book a meeting AND a task in one write, use post.calendar.events with createTask instead. Nothing is defaulted or de-duplicated: with no assigneeAccountId or dueAt the task is unassigned and undated, and the same task raised twice is two tasks — get_tasks with entityRef lists a record's tasks. entityKind alone names no record and is refused — a task about a record carries its entityRef.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredan RFC3339 instant with its offset, such as ; a bare date, a time with no offset, or words like "tomorrow" are not instants
Responses
the action's answer
{}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}