Skip to main content
POST
Backfill canonical contacts from captured chats

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
apply
boolean

Write canonical contacts and actor links. Without this, runs dry-run.

channel
string

Limit to one channel, e.g. whatsapp

createList
string

When applying, add linked chats to this reading list

dryRun
boolean

Force preview mode even if --apply is present

instance
string

Limit to one channel instance/account

limit
string

Maximum candidates to inspect/apply

listOwner
string

Owner for --create-list (default: agent:ravi-crm)

mode
string

Contact intake status: pending|discovered (default: pending)

Response

Success — body conforms to the @Returns schema.

{key}
any