GET
List EXTERNAL Conversations

Overview

List EXTERNAL conversations where the given external user is a participant. Use this to build an inbox or “my conversations” list for SDK/external users. Preferred path: GET /api/v1/sdk/conversations (stable; no route conflict).
Legacy path: GET /api/v1/conversations/external (same behavior when server route order is correct).
Auth: Either Bearer token (SDK token from Issue SDK Token) or API keys (X-Api-Key + X-Api-Secret). With Bearer token, external_user_id is derived from the token and can be omitted.

When to Use

  • Your frontend or backend needs to list conversations for a specific user (e.g. “my chats”).
  • The user is identified by your app’s external_user_id (or from token sub when using Bearer).

Request Headers

*Use either Bearer token or API keys.

Query Parameters

Example: Bearer token (SDK / frontend)

Example: API keys (backend)

Response

Success (200)

Returns an array of conversation objects (same shape as Create EXTERNAL response). Ordered by updated_at descending.

Error Responses

SDK

The JavaScript SDK calls this endpoint when you use client.conversations.list(). Configure apiUrl and either Bearer token (same as WebSocket), API keys, or getRestHeaders(). See SDK Inbox.

Create EXTERNAL (API Key)

Create a conversation

Get EXTERNAL messages

Fetch message history