Skip to main content
GET
Get a conversation

Authorizations

Authorization
string
header
required

Use a workspace API key in the Authorization header. Keys use pk_live_<key_id> for production and pk_test<key_id>_ for test mode.

Path Parameters

conversationId
string
required
Example:

"conv_x6q5vl75f5d53m7oet2k4r5w6a"

Response

Conversation.

Every key is always present; optional fields are null when unset.

id
string
required
Example:

"conv_x6q5vl75f5d53m7oet2k4r5w6a"

externalId
string | null
required
Example:

"inquiry_123"

subject
string
required
Example:

"Inquiry for 2BR Villa in Canggu"

status
string
required

Workspace-defined status key. Every workspace is seeded with open, pending, resolved, and closed; workspaces can define their own. Use GET /v1/statuses to list the keys valid for your workspace. Unknown keys are rejected with conversations.unknown_status.

Pattern: ^[a-z0-9][a-z0-9_-]{0,62}$
Example:

"open"

priority
string
required

Workspace-defined priority key. Every workspace is seeded with low, normal, high, and urgent; workspaces can define their own. Use GET /v1/priorities to list the keys valid for your workspace. Unknown keys are rejected with conversations.unknown_priority.

Pattern: ^[a-z0-9][a-z0-9_-]{0,62}$
Example:

"normal"

channel
string
required
Example:

"whatsapp"

customerId
string
required
Example:

"cus_x6q5vl75f5d53m7oet2k4r5w6a"

assignee
object | null
required

Null when the conversation is unassigned.

team
string | null
required
Example:

"canggu-rentals"

tags
string[]
required
externalObject
object | null
required

Null when no external object is attached.

metadata
object
required
channelIdentityId
string | null
required

The channel identity that opened this conversation, if any.

Example:

"cid_x6q5vl75f5d53m7oet2k4r5w6a"

createdAt
string<date-time>
required
updatedAt
string<date-time>
required
routingNotes
object | null

Routing hints and resolution reasons recorded at create time (debugging).