latestOpenAPI 3.1.02026-08-223871,4712.0 MB

b96b80bcbb83

List Agent Conversation Tickets

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

get/v1/convai/agents/{agent_id}/triage-tickets

Path parameters

agent_idstring required

Query parameters

page_sizeinteger

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

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

conversation_idstring nullable

Filter tickets by conversation id.

Filter tickets by conversation id.

status'open' | 'in_progress' | 'resolved' | 'merged'

Filter tickets by status.

sourcesAgentConversationTicketSource[] nullable

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

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

owner_user_idstring nullable

Filter tickets by creator. Use 'agent' for agent-raised tickets.

Filter tickets by creator. Use 'agent' for agent-raised tickets.

assignee_user_idstring nullable

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

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

issue_type'knowledge_gap' | 'product_feedback' | 'tool_issue' | 'missing_tool' | 'unnecessary_escalation'

Filter clusters by issue type.

labelstring nullable

Filter tickets by an exact label.

Filter tickets by an exact label.

cursorstring nullable

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

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

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successful Response

next_cursorstring nullable
has_moreboolean required