Skip to main content
POST
Read messages from one chat

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

Chat id, platform chat id, phone, group id, or normalized chat id

channel
string

Resolve chat within a channel

includeRaw
boolean

Include raw provider ids and provenance in JSON output

instance
string

Resolve chat within an instance

limit
string

Page size (default: 50, max: 500)

offset
string

Number of matching messages to skip (default: 0)

order
string

Message order (default: asc)

type
string

Resolve chat type: dm|group|thread|room

Response

Success — body conforms to the @Returns schema.

chat
object
required
messages
object[]
required
pagination
object
required
total
number
required