Skip to main content
POST
List recent insights with optional filters

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
agent
string

Filter by linked agent

confidence
string

low|medium|high

fields
string

Compact mode: keep only these fields of each item

importance
string

low|normal|high

kind
string

observation|pattern|win|problem|improvement

limit
string
default:20

Result limit

offset
string

Number of matching insights to skip (default: 0)

profile
string

Filter by linked profile

query
string

Free-text search over summaries/details/comments

rich
boolean

Return rich projection with stats, decorated lineage (task/session/agent refs), and per-link metadata. Honors --limit only; other filters and --fields are ignored.

session
string

Filter by linked session

tag
string

Filter by canonical tag

task
string

Filter by linked task

Response

Success — body conforms to the @Returns schema.

count
number
required
insights
object[]
required
items
object[]
required
pagination
object
required
query
object
required
total
number
required
{key}
any