Resolve conversation reference

GET

/v1/convai/conversations/resolve

GET

/v1/convai/conversations/resolve

$ curl -G https://api.elevenlabs.io/v1/convai/conversations/resolve \
>      -d agent_id=agent_id \
>      -d reference=reference

1 {
2   "agent_id": "agent_3701k3ttaq12ewp8b7qv5rfyszkz",
3   "status": "processing",
4   "metadata": {
5     "start_time_unix_secs": 1714423232,
6     "call_duration_secs": 10,
7     "cost_fiat": 1.1
8   },
9   "conversation_id": "conv_7401k5m9x2p8ec3rqv6dtnhb0fzw",
10   "has_audio": true,
11   "has_user_audio": true,
12   "has_response_audio": true,
13   "has_auxiliary_audio": true,
14   "transcript": [
15     {
16       "role": "user",
17       "time_in_call_secs": 10,
18       "message": "Hello, how are you?"
19     }
20   ],
21   "agent_name": "My agent",
22   "version_id": "agtvrsn_5xM3yVvZQKV0EfqQpLr2",
23   "environment": "production",
24   "tag_ids": []
25 }

Resolve a conversation URL (a Slack message URL or a Zendesk ticket URL) to the deterministic conversation ID for the given agent, then confirm the conversation exists.

Query parameters

agent_idstringRequired

Agent id (agent_…) or speech engine external id (seng_), resolved to the same underlying resource.

referencestringRequired

A Slack message URL or a Zendesk ticket URL.

Response

Successful Response

agent_idstring

statusenum

metadataobject

conversation_idstring

has_audioboolean

has_user_audioboolean

has_response_audioboolean

has_auxiliary_audioboolean

transcriptlist of objects

agent_namestring or null

conversation_productstringDefaults to agent

user_idstring or null

branch_idstring or null

version_idstring or null

The ID of the agent version used for this conversation

analysisobject or null

visited_agentslist of objects

conversation_initiation_client_dataobject

environmentstringDefaults to production

tag_idslist of strings

Conversation tag ids assigned to this conversation.

otlp_tracesmap from strings to any or null

OpenTelemetry trace payload when the request uses format=opentelemetry; otherwise omitted.

Errors

422

Unprocessable Entity Error

Headers

Query parameters

Response

Errors