For the complete documentation index, see llms.txt. This page is also available as Markdown.

List AI agent conversations in an organization

Returns a paginated list of the calling user's AI agent conversations with the organization agent. Unlike change request conversations, these are not tied to a single change request: the agent works across the organization and only attaches a change request when it needs to edit content. A conversation belongs to the user who started it and is never visible to anyone else.

Available in MCP
get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
organizationIdstringRequired

A unique entity identifier

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

Identifier of the page results to fetch.

limitnumber · max: 1000Optional

The number of results per page

Responses
200

A list of agent conversations

application/json
countnumberOptional

Total count of objects in the list

get/orgs/{organizationId}/agent/conversations
GET /v1/orgs/{organizationId}/agent/conversations HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
200

A list of agent conversations

{
  "next": {
    "page": "text"
  },
  "count": 1,
  "items": [
    {
      "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"
    }
  ]
}

Last updated

Was this helpful?

Powered by GitBook