Skip to main content
POST
Start a paid cloud run of a Library agent. Requires --execute.

Body

application/json
agent
string
required

Library agent slug, or a cloud agent id or name

prompt
string
required

What the agent should do

budget
string

Budget for this run in US dollars (0.5-200)

execute
boolean

Start the run (without it, print the plan and exit 3)

idempotencyKey
string

Same key, same run: a retry never starts a second run

project
string

Console project slug (default: the cwd's project)

repo
string[]

Mount a GitHub repository: owner/name[@branch], repeatable

Response

Success — body conforms to the @Returns schema.

run
object
required
success
boolean
required