Skip to main content
POST
Dispatch a task now, or arm a launch plan if dependencies still gate start

Body

application/json
taskId
string
required

Task ID

actorSession
string

Attribute the dispatch to a specific session (overrides RAVI_TASK_ACTOR; useful when a UI dispatches on behalf of a session)

agent
string

Agent ID to receive the task

budget
string

With --cloud: budget of the cloud run in US dollars (0.5-200)

checkpoint
string

Override the assignment checkpoint interval

cloud
boolean

Run it as a paid cloud run of the agent's Library definition instead of a local session

effort
string

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

execute
boolean

Actually dispatch the task; default is a dry-run that only shows the plan (exit 3)

model
string

Dispatch runtime model override

project
string

With --cloud: Console project of the run

reportEvents
string

Override report events for this assignment

reportTo
string

Override the report target for this assignment

session
string

Target session name (defaults to task-specific session)

thinking
string

Runtime thinking: off|normal|verbose

Response

Success — body conforms to the @Returns schema.

event
object
required
mode
string
required
task
object
required
readiness
object
{key}
any