OpenAI

Update a conversation

Replace a conversation's metadata.

Call Create conversation first, then replace conv_123 with the returned conv_ ID.

POST /openai/v1/conversations/{conversation_id}● Supported

Official OpenAI docs ↗

Request parameters

  • conversation_idstring必填

    path:

  • metadataobject必填

    Verified to take effect.

Returns

200 conversation

Updates a conversation's metadata — the whole object is replaced, not merged with the existing metadata.

Errors follow the OpenAI format — see error codes

Response

HTTP 200

The updated conversation

application/json

NameTypeDescription
idstringId of the conversation, such as `conv_...`; use it as `conversation_id` in conversation calls and as `conversation` in createResponse.
objectstringObject type; always `conversation`.
created_atintegerUnix time in seconds at which the conversation was created.
metadataobjectUp to 16 string key/value pairs; keys at most 64 characters and values at most 512.