Skip to main content
POST
Add a new event trigger

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

Trigger name

account
string

Account for channel delivery (auto-detected from agent)

agent
string

Agent ID (default: default agent)

cooldown
string

Cooldown between fires (e.g., 5s, 30s, 1m)

filter
string

Filter expression (e.g. 'data.cwd == "/path/to/workspace"')

message
string

Prompt message

session
string

Session: main or isolated (default: isolated)

topic
string

Notif topic pattern to subscribe to

Response

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

The response is of type object.