Skip to main content
POST
Link a platform identity to a contact

Authorizations

Authorization
string
header
required

Runtime context-key (rctx_*) issued by the Ravi gateway. Used by ordinary gateway operations; not accepted by Console-only operations. 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
contact
string
required

Contact ID or identity

channel
string

Channel, e.g. phone, whatsapp, telegram, slack, email

id
string

Platform user ID

instance
string

Channel instance ID

reason
string

Reason for the link audit event

Response

Success — body conforms to the @Returns schema.

{key}
any