Update an AI agent conversation in an organization

Updates one of the calling user's conversations with the organization agent. Use this to rename it.

Available in MCP

patch

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationIdstringRequired

A unique entity identifier

Pattern: ^[a-zA-Z0-9_-]+$

conversationIdstringRequired

The unique ID of the agent conversation (its client-generated local id, or "default" for the default conversation)

Body

titlestringRequired

The new title of the conversation.

Responses

200

The updated conversation.

application/json

objectstring · enumRequired

Type of Object, always equals to "agent-conversation"

Possible values:

idstringRequired

The unique ID of the conversation. This is the client-generated identifier used to address the conversation; for the default conversation of a change request it is "default".

titlestringOptional

The title of the conversation, generated from the first message. Absent until generated.

sharedbooleanRequired

Whether the conversation is shared with everyone who has access to its context, rather than only its creator. Conversations are shared by default; a private conversation is only ever visible to its creator and stays private for good.

changeRequeststringOptional

The change request the conversation is currently editing in. Only set for organization agent conversations, which start without one and attach a change request the first time the agent needs to change content. Absent for change request conversations, whose change request is the conversation's context.

createdAtstring · date-timeRequired

updatedAtstring · date-timeRequired

patch/orgs/{organizationId}/agent/conversations/{conversationId}

PATCH /v1/orgs/{organizationId}/agent/conversations/{conversationId} HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "title": "text"
}

200

The updated conversation.

{
  "object": "agent-conversation",
  "id": "text",
  "title": "text",
  "shared": true,
  "changeRequest": "text",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}