GET
/conversations/{conversationId}Get a conversation
Get a single conversation by ID. Requires a team-role API key.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
conversationIdrequired | path | string | Conversation ID |
Response
Conversation details
| Field | Type | Description |
|---|---|---|
idrequired | string | TypeID - a type-prefixed UUID |
statusrequired | "open" | "pending" | "closed" | Current conversation status |
channelrequired | "live_chat" | "email" | "web_form" | Channel the conversation arrived on |
priorityrequired | "none" | "low" | "medium" | "high" | "urgent" | Agent-set triage priority |
subjectrequired | string | null | Conversation subject line, null for live-chat threads |
visitorPrincipalIdrequired | string | Principal ID of the visiting user |
visitorEmailrequired | string | null | Captured contact email for the visitor, null if not provided |
assignedAgentPrincipalIdrequired | string | null | Principal ID of the assigned agent, null if unassigned |
lastMessageAtrequired | string | ISO 8601 timestamp |
resolvedAtrequired | string | null | When the conversation was resolved, null while still active |
createdAtrequired | string | ISO 8601 timestamp |
Errors
401Unauthorized404Conversation not foundExample request
curl \
"https://feedback.quackback.io/api/v1/conversations/:conversationId" \
-H "Authorization: Bearer qb_your_api_key_here"