Skip to main content
POST
Create a new insight with lineage captured from the current runtime context

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

Short actionable summary

agent
string

Link the insight to an agent

artifact
string

Link the insight to one artifact path

autoContext
boolean

Auto-link the current runtime session and agent when present

comment
string

Optional initial comment to append after creation

confidence
string

low|medium|high

detail
string

Longer explanation or evidence

importance
string

low|normal|high

kind
string

observation|pattern|win|problem|improvement

Extra link target ID/path

Extra link type: task|session|agent|artifact|profile

profile
string

Link the insight to a task profile

session
string

Link the insight to a session

tag
string[]

Canonical tags; can be repeated or comma-separated

task
string

Link the insight to a task

Response

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

The response is of type object.