Update a conversation
Change a conversation's title, summary, metadata, contact or subject, or close it (status: closed), which starts its analysis. A title or summary written here always wins over the generated one. A call closes by itself (CALL_IN_PROGRESS); a web chat cannot close while the Agent is replying (REPLY_IN_PROGRESS, retry shortly). On WhatsApp, aiEnabled activates or pauses AI only for this open conversation and leaves future episodes unchanged; aiPaused pauses or resumes the Agent for this person until their open conversation closes. Activating or resuming answers what the contact wrote after the last real answer, the team's or the Agent's (a wait notice is not one).
- Scope:
raiz:conversations:write - Credentials: an API key, a client-credentials token or a person's access token
- Effect: writes; idempotent, safe to retry
- Limits: request body up to 32 KB, response up to 1 MB
- CLI:
arbol raiz conversations update· MCP tool:raiz_conversations_update
PATCH
https://api.getarbol.com/v1/raiz/conversations/{conversationId}Authorization
Path parameters
Request body JSON required
Returns
200
Successful operation.
400
INVALID_INPUT: The request does not match the published schema.INVALID_CURSOR: The cursor is malformed or belongs to a different list.
404
NOT_FOUND: The requested operation does not exist.RESOURCE_NOT_FOUND: The requested resource does not exist in this organization.
409
CALL_IN_PROGRESS: A voice conversation closes by itself when its call ends; it cannot be closed by hand.CONVERSATION_OPEN: The conversation is still open. Close it first.REPLY_IN_PROGRESS: The Agent is still replying in this conversation. Try again once the reply is delivered.CHANNEL_NOT_READY: The channel is not connected yet, or this kind of traffic is not enabled on it.CHANNEL_TYPE_MISMATCH: This operation or field does not apply to this channel's type.VERSION_CONFLICT: The resource changed after it was read. Read it again and retry with the new version.
502
OUTCOME_UNKNOWN: The operation may have been applied; check its result before repeating it.
503
UPSTREAM_UNAVAILABLE: The upstream service could not complete the request.INTEGRATIONS_UNAVAILABLE: The organization's integrations cannot be read right now. Try again shortly.