---
title: "Update thread"
method: PATCH
path: "/v1/threads/{threadId}"
tags: ["v1"]
---

# Update thread

`PATCH /v1/threads/{threadId}`

Update thread metadata such as name. Useful for manual thread renaming.

## Path parameters

- `threadId` string, required

## Query parameters

- `userKey` string

## Request body

- UpdateThreadRequest
  - `name` string — Thread name (for manual renaming)
  - `metadata` object — Additional metadata to update

## Response `200`

Updated thread

- UpdateThreadResponse
  - `id` string, required — Unique identifier for this thread
  - `name` string — Thread name (auto-generated or user-set)
  - `userKey` string — Optional user key for thread organization
  - `runStatus` 'idle' | 'waiting' | 'streaming', required — Current run status: idle (no run), waiting (run started, awaiting content), streaming (receiving content)
  - `currentRunId` string — ID of the currently active run (when not idle)
  - `statusMessage` string — Human-readable status message (e.g., 'Fetching weather data...')
  - `lastRunCancelled` boolean — Whether the last run was cancelled
  - `lastRunError` RunError
    - `code` string — Error code
    - `message` string, required — Error message
  - `pendingToolCallIds` string[] — Tool call IDs awaiting client-side results. If non-empty, next run must provide tool_result content with previousRunId set.
  - `lastCompletedRunId` string — ID of the last completed run. Required as previousRunId when continuing after tool calls.
  - `metadata` object — Additional metadata
  - `createdAt` string, required — When the thread was created (ISO 8601)
  - `updatedAt` string, required — When the thread was last updated (ISO 8601)

## Other responses

- `404` — Thread not found

---

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