---
title: "GET /threads/{id}"
method: GET
path: "/threads/{id}"
tags: ["threads"]
---

# GET /threads/{id}

`GET /threads/{id}`

## Path parameters

- `id` string, required

## Query parameters

- `contextKey` string
- `includeInternal` boolean

## Response `200`

- ThreadWithMessages
  - `metadata` object
  - `projectId` string, required
  - `generationStage` 'IDLE' | 'CHOOSING_COMPONENT' | 'FETCHING_CONTEXT' | 'HYDRATING_COMPONENT' | 'STREAMING_RESPONSE' | 'COMPLETE' | 'ERROR' | 'CANCELLED'
  - `statusMessage` string
  - `name` string
  - `id` string, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `messages` ThreadMessage[], required
    - `parentMessageId` string — The id of the parent message, if the message was created during the generation of another message, such as during an agent call, MCP Elicitation, or MCP Sample
    - `metadata` object
    - `reasoning` string[] — Reasoning text from the LLM, if the model supports it.
    - `reasoningDurationMS` number — Duration of reasoning in milliseconds
    - `componentState` object, required
    - `toolCallRequest` ToolCallRequest
      - `tool_call_id` string — The unique id of the tool call, no longer used.
      - `parameters` ToolParameter[], required — The parameters of the function to call.
        - `parameterName` string, required
        - `parameterValue` object, required
      - `toolName` string, required — The name of the function to call.
    - `tool_call_id` string — The unique id of the tool call. This is filled in only if the tool call is a client-side tool call.
    - `actionType` 'tool_call' | 'tool_response' — Deprecated: use the role and the presence of tool calls to determine the action type
    - `error` string
    - `isCancelled` boolean — Whether the message has been cancelled
    - `additionalContext` object — Additional context to provide to the AI beyond the user query, such as the info about the current page the user is visiting.
    - `id` string, required
    - `threadId` string, required
    - `role` 'user' | 'assistant' | 'system' | 'tool', required
    - `content` ChatCompletionContentPart[], required
      - `type` 'text' | 'image_url' | 'input_audio' | 'resource', required — The type of content part
      - `text` string — Text content (when type is 'text')
      - `image_url` ImageUrl
        - `url` string, required
        - `detail` 'auto' | 'high' | 'low'
      - `input_audio` InputAudio
        - `data` string, required
        - `format` 'wav' | 'mp3', required
      - `resource` Resource
        - `uri` string — URI identifying the resource (e.g., file://, https://, s3://)
        - `name` string — Human-readable name for the resource
        - `description` string — Optional description of the resource
        - `mimeType` string — MIME type of the resource
        - `text` string — Inline text content (alternative to uri)
        - `blob` string — Base64-encoded blob data (alternative to uri or text)
        - `annotations` ResourceAnnotations
          - `audience` string[] — Target audience for this resource
          - `priority` number — Priority level for this resource
    - `component` ComponentDecisionV2
      - `props` object, required
      - `componentState` object, nullable, required
      - `toolCallRequest` ToolCallRequest
        - `tool_call_id` string — The unique id of the tool call, no longer used.
        - `parameters` ToolParameter[], required — The parameters of the function to call.
          - `parameterName` string, required
          - `parameterValue` object, required
        - `toolName` string, required — The name of the function to call.
      - `toolCallId` string — The unique id of the tool call. This is filled in whether the tool call is a server-side or client-side tool call.
      - `componentName` string, nullable, required
      - `message` string, required
      - `statusMessage` string
      - `completionStatusMessage` string
    - `tool_calls` object[]
    - `createdAt` string, date-time, required

---

[API](https://skmtc.net/tambo-ai/apis/tambo-api.md) · [All operations](https://skmtc.net/tambo-ai/apis/tambo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tambo-ai/tambo-api/versions/312691b28f1c/schema)