Skip to main content
POST
Explicitly advance one reading-list cursor

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, phone, group id, or normalized chat id

list
string
required

List id or name

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

message
string

Mark read through this durable message id (default: latest)

owner
string

Owner scope when resolving list by name

reader
string

Reader cursor scope (default: current agent)

reason
string

Cursor update reason

Response

Success — body conforms to the @Returns schema.

{key}
any