thread_get

Fetch a single thread’s details. Use it when you have a thread_id, for example from a link or a ping, and need the thread’s name, state, or parent forum.

Request

{
  "cmd": "thread_get",
  "thread_id": "0b7d1c2e-4f3a-4e8b-9a61-5c2d7e9f1a34"
}

Field	Type	Required	Description
`thread_id`	string	Yes	ID of the thread.

Response

{
  "cmd": "thread_get",
  "thread": {
    "id": "0b7d1c2e-4f3a-4e8b-9a61-5c2d7e9f1a34",
    "name": "My first project",
    "parent_channel": "projects",
    "created_by": "alice",
    "created_at": 1788624000,
    "locked": false,
    "archived": false,
    "participants": ["alice", "bob"],
    "message_count": 14,
    "last_message": 1788631200,
    "last_message_id": "8f14e45f-ceea-467a-9575-3d3b4c1b2a10"
  }
}

thread is a thread object. This response goes to the caller only.

Permissions

You need to be able to view the thread’s parent forum.

Errors

`val`	When
`Thread not found`	No thread has this ID.
`You do not have permission to view this thread`	You can’t view the parent forum.
Validation message	`thread_id` is missing or empty, for example `thread_id: Required`.

See also