Skip to main content
POST
Add a new scheduled job

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

Job name

account
string

Account for channel delivery (auto-detected from agent)

agent
string

Agent ID (default: default agent)

at
string

One-shot time (e.g., 2025-02-01T15:00)

cron
string

Cron expression (e.g., '0 9 * * *')

deleteAfter
boolean

Delete job after first run

description
string

Job description

every
string

Interval (e.g., 30m, 1h)

isolated
boolean

Run in isolated session

message
string

Prompt message

tz
string

Timezone (e.g., America/Sao_Paulo)

Response

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

The response is of type object.