Skip to main content
POST
Claim, take over or reply to a widget chat, or return it to the agent

Authorizations

Authorization
string
header
required

A workspace API key, sent as Authorization: Bearer sempera_sk_... Each operation names the one scope it needs. Scopes, key kinds and roles are in the Authentication guide.

Path Parameters

chat_id
string
required

Query Parameters

agent_id
string
required

Body

application/json
action
enum<string>
required
Available options:
claim,
reclaim,
reply,
resume
expected_revision
integer
required
text
string
Maximum string length: 500

Response

OK

id
string
required
widget_id
string
required
agent_id
string
required
handoff
enum<string>
required
Available options:
agent,
waiting,
operator
revision
integer
required
messages
object[]
required
expires_at
string<date-time>
required
held_by_you
boolean

Whether the caller is the desk member holding this chat