POST
POST /v1/convai/triage-tickets — ElevenLabs API
ElevenLabs APICreate Agent Conversation Ticket
- Base URL
- https://api.elevenlabs.io
- Auth
- xi-api-key: <ELEVENLABS_API_KEY>
- Last verified
- 2026-10-20 · upstream hash matched
Actions Try in browser→
Agents: curl -H "Accept: text/markdown" this URL
→ 218 tokens · Vary: Accept
→ 218 tokens · Vary: Accept
Critical gotchas
Authentication uses the non-standard xi-api-key header, not Authorization: Bearer. Sending a Bearer token returns HTTP 401.
Text-to-speech responses are raw binary audio, not JSON. Write the body to a file (--output speech.mp3) rather than parsing it.
cURL
curl -X POST 'https://api.elevenlabs.io/v1/convai/triage-tickets' \ -H "xi-api-key: $ELEVENLABS_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "conversation_id": "conversation-id", "title": "example-title", "qa_comment": "example-qa-comment", "turn_comments": [ { "turn_index": 0, "comment": "example-comment" } ], "priority": "low"}'
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| conversation_id | body | string | Yes | Conversation this ticket is about. |
| title | body | string | No | One-line headline shown in the triage list. Defaults to one derived from the comments, falling back to the conversation's summary title. Ignored when the comment is added to the conversation's open ticket. |
| qa_comment | body | string | No | The issue this ticket is about, covering the whole conversation rather than a single turn. |
| turn_comments | body | object[] | No | Optional turn-level comments on what went wrong. |
| priority | body | string | No | How urgently the ticket needs attention. If the conversation already has an open ticket, it is raised to this priority when lower. |
Response 200 OK
{
"agentqa_ticket_id": "string",
"workspace_id": "string",
"owner_user_id": "string",
"agent_id": "string",
"needs_clustering": true,
"title": "string",
"issue_type": "knowledge_gap",
"labels": [
"string"
],
"conversation_ids": [
"string"
],
"first_seen_unix_secs": 0,
"last_seen_unix_secs": 0,
"qa_comment": "string",
"ticket_comments": [
{
"comment": "string",
"created_at_unix_secs": 0,
"owner_user_id": "string"
}
],
"turn_comments": [
{
"turn_index": 0,
"comment": "string",
"created_at_unix_secs": 0,
"owner_user_id": "string"
}
],
"status": "open",
"priority": "low",
"priority_changes": [
{
"priority": "low",
"changed_by_user_id": "string",
"changed_at_unix_secs": 0
}
],
"status_changes": [
{
"status": "open",
"changed_by_user_id": "string",
"changed_at_unix_secs": 0
}
],
"merged_into_ticket_id": "string",
"source": "qa",
"assignee_user_id": "string",
"created_at_unix_secs": 0,
"updated_at_unix_secs": 0,
"search_match": {
"field": "title",
"snippet": "string",
"highlight_start": 0,
"highlight_end": 0,
"turn_index": 0
}
} Get a free ElevenLabs API key → sponsored Affiliate link - we may earn a commission, at no extra cost to you.