Skip to main content
POST
Ensure one canonical direct chat between an actor and an agent

Authorizations

Authorization
string
header
required

Runtime context-key (rctx_*) issued by the Ravi gateway. Required for every non-open scope. Bootstrap the first key with ravi daemon init-admin-key; rotate, derive, and revoke via the ravi context family. Specs: runtime/context-keys, sdk/auth.

Body

application/json
actorId
string
required

Canonical actor id

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9][A-Za-z0-9._~-]{0,127}$
agentId
string
required

Target agent id

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9][A-Za-z0-9._~-]{0,127}$
clientRequestId
string
required

Caller-owned request id

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9][A-Za-z0-9._~-]{0,127}$

Response

Success — body conforms to the @Returns schema.

chat
object
required
clientRequestId
string
required
disposition
enum<string>
required
Available options:
created,
existing