Skip to main content
POST
Take, pass or release a conversation
Changes the owner of one conversation (one customer). The id accepts the connection id or the session id (cloud-<uuid>). Full guide, with use cases and webhooks: Multiple partners on the same number.

Example

Errors

Authorizations

Authorization
string
header
required

API Key for authentication. Format: <API_KEY>

Path Parameters

id
string
required
Minimum string length: 1

Body

action
required
Allowed value: "take"
to
string
required
Minimum string length: 1
targetRole
Allowed value: "ai_agent"
metadata
string
Maximum string length: 2000

Response

Successful response

success
boolean
required
data
any
error
string
code
string