Merge Agent Conversation Tickets

Merge other open tickets of the same agent into this pending, in-progress, or resolved one. Their conversations move onto this ticket, its priority is raised to the highest among them, and they are kept with status 'merged'. Requires viewer access to the ticket's agent.

post/v1/convai/triage-tickets/{agentqa_ticket_id}/merge

Path parameters

agentqa_ticket_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

source_ticket_idsstring[] required

Open tickets of the same agent to fold into this one. They are kept with status 'merged', pointing at this ticket.

Response

Successful Response

agentqa_ticket_idstring required
workspace_idstring required
owner_user_idstring required
agent_idstring required
needs_clusteringboolean required
titlestring nullable required

One-line headline for the ticket. None only on tickets created before titles existed.

issue_type'knowledge_gap' | 'incorrect_information' | 'documentation_gap' | 'product_feedback' | 'platform_bug' | 'tool_issue' | 'missing_tool' | 'unnecessary_escalation' | 'wrong_action' 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' | 'cancelled' | 'merged' required
priority'low' | 'medium' | 'high' | 'urgent' required
merged_into_ticket_idstring nullable

The ticket this one was merged into, set while its status is 'merged'.

source'qa' | 'agent' | 'manual' required
assignee_user_idstring nullable required
created_at_unix_secsinteger required
updated_at_unix_secsinteger required

Changes

Changed in 1 of the 59 revisions of this API.1