ai.v1.AssistantService

ListConversations

ListConversations lists the caller's conversations, most recently updated first. Errors: - INVALID_ARGUMENT: malformed request or page token. - UNAVAILABLE: SERVICE_UNAVAILABLE; retry later. - UNAUTHENTICATED: missing or invalid credentials.

Method

POST

Path

ai.v1.AssistantService/ListConversations

Service

ai.v1.AssistantService

Visibility

Authentication required

Authentication

Session token

MFA Requirement

Not required

POST

ai.v1.AssistantService/ListConversations

Request

Testnet

curl --request POST \ \
  --url 'https://api.testnet.polyester.com/ai.v1.AssistantService/ListConversations' \
  --header 'Content-Type: application/json' \
  --header 'Connect-Protocol-Version: 1' \
  --data '{
  "limit": 100,
  "pageToken": "eyJvZmZzZXQiOjEwMH0"
}'

Responses

{
  "conversations": [
    {
      "conversationId": "1",
      "createdAt": "2025-01-01T00:00:00Z",
      "title": "My Trading Board",
      "updatedAt": "2025-01-01T00:00:00Z"
    }
  ],
  "nextPageToken": "eyJvZmZzZXQiOjIwMH0"
}

Request

ai.v1.ListConversationsRequest

Response

ai.v1.ListConversationsResponse

limit integer (int32) ≤ 100

Maximum conversations to return. 0 means the default of 20; maximum 100.

pageToken string max 512 chars

Opaque, keyset-backed, exclusive cursor from a previous response. Bound to the caller, updated_at and conversation_id.

4 fields

nextPageToken string

Cursor for the next page. Empty when no more results exist.

Possible errors: 5

Key	HTTP status	Connect code	Error	When
unauthenticated	401	unauthenticated	Unauthenticated	Authentication required.
permission-denied	403	permission_denied	Permission Denied	Permission denied.
invalid-argument	400	invalid_argument	Invalid Argument	Invalid argument.
not-found	404	not_found	Not Found	Not found.
unavailable	503	unavailable	Unavailable	Service unavailable.