Skip to main content
POST
Link a platform identity to an agent (bot senders resolve to an agent actor)

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
agent
string
required

Agent ID that owns the platform identity

channel
string

Channel, e.g. slack, telegram, discord

id
string

Platform user ID

instance
string

Channel instance ID

name
string

Platform display name

reason
string

Reason for the link audit event

Response

Success — body conforms to the @Returns schema.

agent
string
required
identity
object
required
status
string
required
Allowed value: "linked"