Skip to main content
POST
Start a long command in the background and return immediately

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
command
string[]
required

Command to run (after --)

agent
string

Agent that owns the job

cwd
string

Working directory

session
string

Session to notify when the job finishes

wait
boolean

Block until the job finishes, then print the tail

Response

Success — body conforms to the @Returns schema.

command
string
required
hint
string
required
id
string
required
logPath
string
required
sessionName
string | null
required
status
string
required