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

# Update a thread

`PATCH /v1/fleet/threads/{thread_id}`

Updates thread fields such as title and metadata. Omitted fields are unchanged; null values clear fields where supported.

## Path parameters

- `thread_id` string, required

## Request body

- ThreadsUpdateThreadRequest
  - `metadata` ThreadsUpdateThreadMetadata
    - `is_pinned` ThreadsOptionalFieldBool
      - `set` boolean
      - `value` boolean
    - `is_test_run` ThreadsOptionalFieldBool
      - `set` boolean
      - `value` boolean
    - `read_status` ThreadsOptionalFieldBool
      - `set` boolean
      - `value` boolean
    - `sandbox_recreated_at` ThreadsOptionalFieldString
      - `set` boolean
      - `value` string
    - `skip_memory_write_protection` ThreadsOptionalFieldBool
      - `set` boolean
      - `value` boolean
  - `title` ThreadsOptionalFieldString
    - `set` boolean
    - `value` string

## Response `200`

OK

- ThreadsUpdateThreadResponse
  - `agent_id` string, uuid
  - `created_at` string, date-time
  - `id` string, uuid
  - `metadata` ThreadsUpdateThreadMetadata
    - `is_pinned` ThreadsOptionalFieldBool
      - `set` boolean
      - `value` boolean
    - `is_test_run` ThreadsOptionalFieldBool
      - `set` boolean
      - `value` boolean
    - `read_status` ThreadsOptionalFieldBool
      - `set` boolean
      - `value` boolean
    - `sandbox_recreated_at` ThreadsOptionalFieldString
      - `set` boolean
      - `value` string
    - `skip_memory_write_protection` ThreadsOptionalFieldBool
      - `set` boolean
      - `value` boolean
  - `title` string
  - `updated_at` string, date-time

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `502` — Bad Gateway

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/revisions/a0acb3a6a101/schema)