Agents

Update agent conversation title

Changed on Oct 28, 2026

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 title is trimmed before it is saved; a whitespace-only title is refused with 400 (VALIDATION_ERROR). Unknown body fields are dropped and query parameters are ignored.

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

Request

Base URL
https://app.pipeshub.com/api/v1
URL
https://app.pipeshub.com/api/v1/agents/{agentKey}/conversations/{conversationId}/title
Auth
- HTTP bearer
- or OAuth 2
  Authorization code: /api/v1/oauth2/authorize
  Client credentials
  Token URL: /api/v1/oauth2/token scopes: agent:write

Path parameters

agentKeystring required

conversationIdstring objectId required

Request body

titlestring required

New title for the conversation. Surrounding whitespace is trimmed; a blank title is refused.

Example request

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

Response

Title updated successfully

Changes

Oct 28, 2026dbb5e203b445 Revision changes
- breaking
  added the pattern \S to the request property
- breaking
  the ///// response's property type changed from object to no type for status
- breaking
  the ///// response's property type changed from object to no type for status
- breaking
  the ///// response's property type changed from object to no type for status
- breaking
  the ///// response's property type changed from object to no type for status
- breaking
  the ///// response's property type changed from object to no type for status
- breaking
  the //// response's property type changed from object to no type for status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ////// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- warning
  removed the optional property ///// from the response with the status
- info
  added the media type application/x-www-form-urlencoded to the request body
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added to the ///// response property anyOf list for the response status
- info
  added to the ///// response property anyOf list for the response status
- info
  added to the ///// response property anyOf list for the response status
- info
  added to the ///// response property anyOf list for the response status
- info
  added to the ///// response property anyOf list for the response status
- info
  added to the //// response property anyOf list for the response status
- info
  added subschema #1 to the //// response property anyOf list for the response status
Oct 21, 2026a90ab79f26a1 Revision changes
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property ////// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////////// to the response with the status

Operation history (6 revisions)