Sign in
Agents

Update agent conversation title

Updates the display title for an agent conversation owned by the caller.

The controller looks up the conversation by _id, orgId, userId, agentKey, and isDeleted: false.

The request body uses the shared title validator (1..200 chars), and the controller trims the incoming title before saving it. A whitespace-only title can therefore still return HTTP 400 even if the raw string is non-empty.

patch/agents/{agentKey}/conversations/{conversationId}/title

Path parameters

agentKeystring required
conversationIdstring objectId required

Request body

titlestring required

New title for the conversation

Example request

{
  "title": "ABC News Follow-up"
}

Response

Title updated successfully

Changes

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

  • 5798f431973a12See 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

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

  • 8255239599bf1See the full diff
    • ○

      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