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. 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 linked agent

confidence
string

low|medium|high

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 are ignored.

session
string

Filter by linked session

tag
string

Filter by canonical tag

task
string

Filter by linked task

Response

Success — no @Returns schema declared; payload shape is loose.

The response is of type object.