---
title: "Get Thread"
method: GET
path: "/threads/{thread_id}"
tags: ["Threads"]
---

# Get Thread

`GET /threads/{thread_id}`

Retrieve a specific thread by its UUID, including all its messages.

## Path parameters

- `thread_id` string, uuid, required

## Headers

- `authorization` string, nullable
- `x_session_token` string, nullable

## Response `200`

Successful Response

- Thread
  - `metadata_` object, nullable
  - `thread_id` string, uuid, required
  - `assistant_id` string, uuid, nullable
  - `created_at` string, date-time, required
  - `title` string, nullable
  - `first_user_message` string, nullable
  - `message_count` integer, nullable
  - `updated_at` string, date-time, nullable
  - `messages` MessageWithAttachments[]
    - `role` 'user' | 'assistant' | 'tool', required
    - `content` string, nullable
    - `metadata_` object, nullable — Stores tool_calls, tool_call_id, run_id, error details etc.
    - `status` 'IN_PROGRESS' | 'REQUIRES_ACTION' | 'COMPLETED' | 'FAILED' | 'CANCELLED'
    - `message_id` string, uuid, required
    - `model_provider` string, nullable
    - `model_name` string, nullable
    - `input_tokens` integer, nullable
    - `output_tokens` integer, nullable
    - `total_tokens` integer, nullable
    - `created_at` string, date-time, required
    - `attachments` AttachmentInfo[]
      - `document_id` string, uuid, required
      - `filename` string, required
      - `status` string, required
      - `file_size_bytes` integer, required
      - `summary` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/backboard/apis/backboard-api.md) · [All operations](https://skmtc.dev/backboard/apis/backboard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/backboard/backboard-api/revisions/e732d11ca11a/schema)