Skip to main content
POST
Send a prompt to a session (fire-and-forget). Use -w to wait for response, -i for interactive.

Body

application/json
nameOrKey
string
required

Session name

agent
string

Agent to use when creating a new session

barrier
string

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

channel
string

Override delivery channel

effort
string

Runtime effort: none|minimal|low|medium|high|xhigh|max|ultra

immediate
boolean

Deliver immediately instead of queueing as a follow-up

interactive
boolean

Interactive mode

prompt
string

Prompt to send (omit for interactive mode)

raw
boolean

Send the prompt without [System] Inform wrapping

steer
boolean

Steer the active turn after safe tool barriers

thread
string

Attach or auto-create a Ravi thread

threadOwner
string

Owner for thread auto-create

threadScope
string

Scope for thread lookup/create

threadSummary
string

Initial summary when --thread auto-creates

threadTitle
string

Title required when --thread auto-creates

to
string

Override delivery target

wait
boolean

Wait for this turn's reply (CLI transcript or delivered chat)

Response

Success — body conforms to the @Returns schema.

action
string
required
Allowed value: "send"
createdSession
boolean
required
delivery
object
required
mode
enum<string>
required
Available options:
fire-and-forget,
wait
promptLength
integer
required
Required range: 0 <= x <= 9007199254740991
published
boolean
required
session
object
required
thread
object | null
required
response
object
{key}
any