---
title: "Update title"
method: PATCH
path: "/chrt_gpt/conversations/update_title/v1/{conversation_id}"
tags: ["/chrt_gpt"]
---

# Update title

`PATCH /chrt_gpt/conversations/update_title/v1/{conversation_id}`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/chrt_gpt/conversations/update_title/v1/{conversation_id}`
- Auth: HTTP bearer

Renames one of the caller's ChrtGPT conversations; ChrtGPT never retitles it after that. | authz: allowed_org_types=[shipper, provider], min_org_role=operator | (ChrtGPTConversationsUpdateTitleReq) -> (ChrtGPTConversation1)

## Path parameters

- `conversation_id` string, required

## Request body

- ChrtGPTConversationsUpdateTitleReq
  - `title` string, required

## Response `200`

Successful Response

- ChrtGPTConversation1
  - `schema_version` 1, required
  - `_id` string, required
  - `org_id` string, required: Must be a string starting with `org_`
  - `user_id` string, required: Must be a string starting with `user_`
  - `title` string, required
  - `title_source` 'fallback' | 'ai' | 'user', required
  - `summary` string, nullable
  - `summarized_turn_count` integer
  - `order_short_ids` string[]
  - `awb_numbers` string[]
  - `off_chrt_reference_ids` string[]
  - `context_tokens` integer, nullable
  - `conversation_s3_object_metadata_ids` string[]
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-29** `6f428e2e2b98`: 1 info
  - added the optional property `conversation_s3_object_metadata_ids` to the response with the `200` status
- **2026-10-13** `2cbb4c8fec86`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/chrt/apis/chrt-fastapi/changes/chrt_gpt/conversations/update_title/v1/:conversation_id/patch.md)

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) - [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/chrt/apis/chrt-fastapi/revisions/6f428e2e2b98?raw)