List tickets

GET

/v1/convai/agents/:agent_id/triage-tickets

GET

/v1/convai/agents/:agent_id/triage-tickets

curl https://api.elevenlabs.io/v1/convai/agents/agent_id/triage-tickets

{
  "agent_conversation_tickets": [
    {
      "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": 1,
      "last_seen_unix_secs": 1,
      "qa_comment": "string",
      "ticket_comments": [
        {
          "comment": "string",
          "created_at_unix_secs": 1,
          "owner_user_id": "string"
        }
      ],
      "turn_comments": [
        {
          "turn_index": 1,
          "comment": "string",
          "created_at_unix_secs": 1,
          "owner_user_id": "string"
        }
      ],
      "status": "open",
      "priority": "low",
      "priority_changes": [
        {
          "priority": "low",
          "changed_by_user_id": "string",
          "changed_at_unix_secs": 1
        }
      ],
      "status_changes": [
        {
          "status": "open",
          "changed_by_user_id": "string",
          "changed_at_unix_secs": 1
        }
      ],
      "source": "qa",
      "assignee_user_id": "string",
      "created_at_unix_secs": 1,
      "updated_at_unix_secs": 1,
      "merged_into_ticket_id": "string",
      "search_match": {
        "field": "title",
        "snippet": "string",
        "highlight_start": 1,
        "highlight_end": 1,
        "turn_index": 1
      }
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

List an agent’s conversation triage tickets, ordered by most recently created first unless sorted by priority. These are tickets about the agent’s own performance on a conversation (for triage with Architect), not tickets an agent opens for end users.

Path parameters

agent_idstringRequired

Query parameters

page_sizeintegerOptional1-100Defaults to 100

How many agent conversation tickets to return. Can not exceed 100.

conversation_idstring or nullOptional

Filter tickets by conversation id.

statusenum or nullOptional

Filter tickets by status.

Allowed values:

sourceslist of enums or nullOptional

Filter tickets by how they were raised (qa, agent, manual). Repeat the parameter to filter by multiple sources.

Allowed values:

prioritieslist of enums or nullOptional

Filter tickets by priority. Repeat the parameter to filter by multiple priorities.

Allowed values:

sort_byenumOptional

Order by most recently created, by priority (most urgent first, then most recently created), or by most recently reported (the newest report merged into the issue, else its creation).

Allowed values:

owner_user_idstring or nullOptional

Filter tickets by creator. Use ‘agent’ for agent-raised tickets.

assignee_user_idstring or nullOptional

Filter tickets by assignee. Use 'unassigned' for tickets with no assignee.

issue_typeenum or nullOptional

Filter clusters by issue type.

labelstring or nullOptional

Filter tickets by an exact label.

merged_into_ticket_idstring or nullOptional

Filter tickets merged into this ticket.

searchstring or nullOptional<=200 characters

Case-insensitive free-text search across the ticket’s title, description, comments, and turn comments.

cursorstring or nullOptional

Used for fetching next page. Cursor is returned in the response.

Response

Successful Response

agent_conversation_ticketslist of objects

has_moreboolean

next_cursorstring or nullOptional

Errors

422

Unprocessable Entity Error

Path parameters

Headers

Query parameters

Response

Errors