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

# Get Thread State

`GET /threads/{thread_id}/state`

Get state for a thread.

The latest state of the thread (i.e. latest checkpoint) is returned.

## Path parameters

- `thread_id` string, uuid, required — The ID of the thread.

## Response `200`

Success

- ThreadState
  - `values` union, required
    - object[]
    - object
  - `next` string[], required
  - `tasks` object[]
    - `id` string, required
    - `name` string, required
    - `error` string
    - `interrupts` unknown[]
      - unknown
    - `checkpoint` CheckpointConfig — Checkpoint config.
      - `thread_id` string — Unique identifier for the thread associated with this checkpoint.
      - `checkpoint_ns` string — Namespace for the checkpoint, used for organization and retrieval.
      - `checkpoint_id` string — Optional unique identifier for the checkpoint itself.
      - `checkpoint_map` object — Optional dictionary containing checkpoint-specific data.
    - `state` ThreadState — recursive
  - `checkpoint` CheckpointConfig, required — Checkpoint config.
    - `thread_id` string — Unique identifier for the thread associated with this checkpoint.
    - `checkpoint_ns` string — Namespace for the checkpoint, used for organization and retrieval.
    - `checkpoint_id` string — Optional unique identifier for the checkpoint itself.
    - `checkpoint_map` object — Optional dictionary containing checkpoint-specific data.
  - `metadata` object, required
  - `created_at` string, required
  - `parent_checkpoint` object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/xpert-ai/apis/agent-protocol.md) · [All operations](https://skmtc.net/xpert-ai/apis/agent-protocol/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xpert-ai/agent-protocol/versions/ac9dbe16ea2f/schema)