Skip to main content
POST
Create a session followup cadence

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

Followup cadence name

at
string

One-shot schedule timestamp

barrier
string

Delivery barrier: followup|steer|p0|p1|p2|p3

cron
string

Cron expression

description
string

Description for humans

disabled
boolean

Create disabled/paused

every
string

Idle followup after inactivity, e.g. 30m, 2h, 1d

message
string

Followup message template

owner
string

Owner scope (default: current agent or system:ravi)

step
string[]

Idle followup step; repeat or quote, e.g. --step '2h=First followup' --step '3h=Second followup'

targetChat
string

Target one canonical chat id/ref

targetList
string

Target every active chat in a reading list

targetSession
string

Target one session by name or key

timezone
string

Timezone for cron schedules

Response

Success — body conforms to the @Returns schema.

{key}
any