Developer Docs Logo
API RequestsAPI SchemaChats

Get Conversation Detail

GET/v1/conversations/{conversation_id}

Retrieves detailed information about a specific conversation including participants and status. Requires chat:read scope.

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

conversation_id*string

The unique identifier (UUID) of the conversation to retrieve.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/conversations/8b86b34d-3d4e-4f20-9d55-9d4c93d0b8a2"
{  "data": {    "id": "7c9b5f38-76b6-4c7e-a0c9-5fb6f8c6d0d3",    "status": "OPEN",    "channel_id": "a24f8ef9-2da9-47e0-9be5-0dbeb40a8d54",    "created_at": "2024-01-15T10:00:00Z",    "contact_id": "550e8400-e29b-41d4-a716-446655440000",    "assignee_id": "9e9097a8-5c9a-4e1e-8218-3b833d8b0039",    "participants": [      {        "id": "9e9097a8-5c9a-4e1e-8218-3b833d8b0039",        "name": "Jane Agent",        "type": "AGENT"      },      {        "id": "2a4aa2fc-2783-4c5e-9d3c-e0bbf2a12487",        "name": "Support Bot",        "type": "BOT"      }    ],    "custom_action_user_token": "usr_tkn_1N3WkpIh2V"  }}

Get Attachment URL GET

Retrieves the signed URL for an attachment. The signed URL can be used to access the attachment file. Requires `chat:read` scope.

Get Conversation List GET

Retrieves a paginated list of conversations with filtering options. Supports filtering by assignee, contact, status, date range, and channel. Requires `chat:read` scope.