---
title: "Update a conversation."
method: POST
path: "/v1/conversations/{conversation_id}"
tags: ["Conversations"]
---

# Update a conversation.

`POST /v1/conversations/{conversation_id}`

Update a conversation's metadata with the given ID.

## Path parameters

- `conversation_id` string, required — The conversation identifier.

## Request body

- UpdateConversationRequest — Request model for updating a conversation's metadata.
  - `metadata` object, required — Set of key-value pairs that can be attached to an object.

## Response `200`

The updated conversation object.

- Conversation — OpenAI-compatible conversation object.
  - `id` string, required — The unique ID of the conversation.
  - `object` 'conversation' — The object type, which is always conversation.
  - `created_at` integer, required — The time at which the conversation was created, measured in seconds since the Unix epoch.
  - `metadata` object, nullable — Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard.

## Other responses

- `400` — The request was invalid or malformed
- `429` — The client has sent too many requests in a given amount of time
- `500` — The server encountered an unexpected error
- `default` — An error occurred

---

[API](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis.md) · [All operations](https://skmtc.net/ogx-ai/apis/ogx-specification-stable-experimental-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ogx-ai/ogx-specification-stable-experimental-apis/versions/f3f783962256/schema)