Sign in
Conversations

Update conversation title

Update the title of a conversation.

Overview:

Conversation titles are auto-generated from the first query by default. Use this endpoint to set a custom, more descriptive title.

Title limits:

  • Minimum: 1 character
  • Maximum: 200 characters

Permissions:

The conversation must exist, belong to the calling user's organization, be owned by the caller (matched on userId), and not be soft-deleted.

patch/conversations/{conversationId}/title

Path parameters

conversationIdstring objectId required

Unique conversation identifier

Request body

titlestring required

New conversation title

Example request

{
  "title": "Q4 Sales Analysis Discussion"
}

Response

Title updated successfully

Changes

Changed in 2 of the 15 revisions of this API.113

  • 5798f431973a13See the full diff
    • ●

      added the new tool_call enum value to the conversation/messages/items/messageType response property for the response status 200

      response-property-enum-value-added

    • ○

      added the optional property conversation/messages/items/parts to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property conversation/messages/items/reasoning to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property conversation/messages/items/tools to the response with the 200 status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 911a57b55d181See the full diff
    • ▲

      the response property conversation/messages/items/confidence became nullable for the status 200

      response-property-became-nullable