apicheats.dev elevenlabs/llms.txt Raw .md
POST

POST /v1/convai/triage-tickets — ElevenLabs API

ElevenLabs API

Create 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

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.