latestOpenAPI 3.1.02026-08-223871,4712.0 MB

b96b80bcbb83

Create Manual Agent Ticket

Manually raise a follow-up ticket against an agent, not tied to any conversation (for example a task like 'add the KB about X'). The comment is shown as the ticket title. Requires viewer access to the agent.

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

Path parameters

agent_idstring required

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.

Request body

qa_commentstring required

What the ticket is about, e.g. a follow-up task for the agent. This is shown as the ticket title.

Response

Successful Response

agentqa_ticket_idstring required
workspace_idstring required
owner_user_idstring required
agent_idstring required
needs_clusteringboolean required
issue_type'knowledge_gap' | 'product_feedback' | 'tool_issue' | 'missing_tool' | 'unnecessary_escalation' required
labelsstring[] required
conversation_idsstring[] required
first_seen_unix_secsinteger nullable required
last_seen_unix_secsinteger nullable required
qa_commentstring nullable required
status'open' | 'in_progress' | 'resolved' | 'merged' required
source'qa' | 'agent' | 'manual' required
assignee_user_idstring nullable required
created_at_unix_secsinteger required
updated_at_unix_secsinteger required