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

# PUT /threads/{id}

`PUT /threads/{id}`

## Path parameters

- `id` string, required

## Request body

- ThreadRequest
  - `contextKey` string — Unique user identifier for the thread
  - `metadata` object
  - `projectId` string, required
  - `generationStage` 'IDLE' | 'CHOOSING_COMPONENT' | 'FETCHING_CONTEXT' | 'HYDRATING_COMPONENT' | 'STREAMING_RESPONSE' | 'COMPLETE' | 'ERROR' | 'CANCELLED'
  - `statusMessage` string
  - `name` string

## Response `200`

- Thread
  - `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

---

[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)