Update a conversation
PATCH/conversations/:conversation_id
Change assignment, routing, priority, flag, labels, subject or status. Only the fields you send are touched.
status accepts open, pending and resolved. Moving to on_hold is
not allowed here, because a hold carries a deadline — use
POST /v1/conversations/{id}/hold. Moving out of on-hold by setting another
status works and clears the deadline.
Two assignments have side effects worth knowing about:
- Assigning a team whose auto-assign rule is on immediately hands the conversation to a random online member.
- Assigning an AI agent starts an AI session; the response carries an
assignmentobject with itsai_session_id. Assigning a human to a conversation an AI is handling ends that session silently — the human takeover the console does.
Request
Responses
- 200
- 400
- 401
- 403
- 404
The updated conversation.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
The request was malformed, or a parameter was rejected.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
No token, an expired token, or a credential that has been revoked.
Response Headers
Correlation id for this request. Quote it when reporting a problem.
Refused. Either the credential does not hold the scope this endpoint needs (code: insufficient_scope), or the account's IP allow-list does not include the calling address (code: ip_not_allowed).
Response Headers
Correlation id for this request. Quote it when reporting a problem.
No such resource in this account.
Response Headers
Correlation id for this request. Quote it when reporting a problem.