Skip to main content
POST
End Conversation
Enterprise Feature - SMS is only available on Enterprise plans.
Ends the conversation without handing it back to the agent. Use it when a human rep has finished a thread they took over and the agent should not resume, or whenever your platform wants to close an active thread cleanly. It also works on threads that were never handed off. The conversation is marked inactive, any human handoff is cleared (its audit trail is kept in the conversation’s metadata.last_human_handoff), the inactivity timer is cancelled, post-conversation analysis runs (summary, citations, dispositions), and a single status: "ended" status webhook fires with the same payload an End Call node produces. No human_handoff_ended webhook is sent; ended is the final event.
Nothing is sent to the customer. If the rep wants to say goodbye, send it first with Send Message on Conversation, then call this. The next inbound text from the customer starts a fresh conversation with the agent.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The conversation to end.

Body Parameters

string
Surfaced as status_reason on the ended webhook. Max 500 characters. Defaults to “Conversation ended by the human rep” when a handoff was active, otherwise “Conversation ended via API”.
string
Who ended the thread, for the audit trail.

Response

boolean
false when the conversation was already over. Nothing is changed and no webhook fires in that case; whatever ended it already sent one.
boolean
true when a human owned the thread at the moment it was ended.