Get one task

{
  "data": {
    "assignments": [
      {
        "active_form": "string",
        "assignee": {
          "id": "string",
          "name": "string",
          "type": "User",
          "handle": "string"
        },
        "linked_native_id": "string",
        "status": "pending",
        "updated_at": "2024-01-15T09:30:00Z"
      }
    ],
    "chat_room_id": "string",
    "created_by": {
      "id": "string",
      "name": "string",
      "type": "User",
      "handle": "string"
    },
    "detail": "string",
    "id": "string",
    "inserted_at": "2024-01-15T09:30:00Z",
    "number": 1,
    "overall_status": "pending",
    "state": "active",
    "subject": "string",
    "superseded_by_id": "string",
    "updated_at": "2024-01-15T09:30:00Z",
    "history": [
      {
        "actor": {
          "id": "string",
          "name": "string",
          "type": "User",
          "handle": "string"
        },
        "at": "2024-01-15T09:30:00Z",
        "event": "created",
        "payload": {}
      }
    ],
    "history_truncated": true
  }
}

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