Skip to main content
POST
List recent canonical 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
agent
string

Filter by agent id

channel
string

Filter by channel, e.g. whatsapp

contact
string

Filter by contact id, phone, or identity

fields
string

Compact mode: keep only these fields of each item

includeRaw
boolean

Include raw provider ids and provenance in JSON output

instance
string

Filter by instance name or Omni instance id

limit
string

Page size (default: 25, max: 500)

offset
string

Number of matching chats to skip (default: 0)

query
string

Search chat ids, titles, and message content

type
string

Filter by chat type: dm|group|thread|room

Response

Success — body conforms to the @Returns schema.

chats
object[]
required
items
object[]
required
pagination
object
required
total
number
required