Request APIAgent APIChat Tasks (Beta)

Get one task

Reads one task by UUID or board number (“/tasks/3” is task #3). Works for any lifecycle state — cancelled/superseded/archived tasks stay readable as audit records. Pass ?include=history to embed the task’s change-and-comment history (most recent 100 events, oldest first; history_truncated tells you to use the history endpoint for the full ledger).

Authentication

X-API-Keystring
Enter your API key for programmatic access

Path parameters

chat_idstringRequiredformat: "uuid"
Chat room ID
idstringRequired
Task UUID or board number

Query parameters

includeenumOptional
Set to "history" to embed the recent event history
Allowed values:

Response

Task
dataobject

A shared task on a chat room’s board. Tasks are never deleted — they are cancelled, superseded, or archived (reversible), and stay readable forever. Address a task by its UUID or its board number (“#3” -> /tasks/3).

Errors

401
Unauthorized Error
404
Not Found Error