List conversation threads

POST 
/api/v1/llm/list-threads

Returns a paginated list of conversation threads for the authenticated user, ordered by lastMessageAt descending, then threadId descending for ties. Changes to updatedAt alone do not change the list position.

Pass nextPageToken as pageToken to continue after the last returned thread in that order. Pages read the current conversation projection; they do not share a point-in-time snapshot. Concurrent message activity can move a thread ahead of a continuation token, so a multi-page traversal can miss threads that move while it is in progress.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Build a support conversation the user can return to · Connect signed-in users to their conversations · Build a signed-in support chat that survives reconnects · Complete your first support-chat turn

Request

Responses

200

Threads listed successfully

List the authenticated user’s conversations with default paging.

Section ID: DOC-MA-conversations-api-listThreads#example-conversations-listThreads-request

Request example

{}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-MA-conversations-api-listThreads#example-conversations-listThreads-response

Response example

{
  "threads": [
    {
      "threadId": "example_123",
      "userId": "example_123",
      "title": "example",
      "tags": [
        "example"
      ],
      "status": "CONVERSATION_STATUS_ACTIVE",
      "messageCount": "1",
      "lastMessagePreview": "example",
      "lastMessageAt": "2026-09-16T12:00:00Z",
      "createdAt": "2026-09-16T12:00:00Z",
      "updatedAt": "2026-09-16T12:00:00Z",
      "externalId": "example_123"
    }
  ],
  "nextPageToken": "example"
}

Illustrative response for Verify credentials with your first call. Replace example resource identifiers with your own authorized values.

Section ID: DOC-MA-conversations-api-listThreads#example-cookbook-managed-agents-conversations-build-chat-assistant-json-01-response

Response example

{}

Document ID: DOC-MA-conversations-api-listThreads. Section identities and revisions.

Section	Stable reference
List conversation threads	DOC-MA-conversations-api-listThreads#overview
Request	DOC-MA-conversations-api-listThreads#request
Responses	DOC-MA-conversations-api-listThreads#responses