Skip to main content
POST
Create a new agent

Authorizations

Authorization
string
header
required

Runtime context-key (rctx_*) issued by the Ravi gateway. Used by ordinary gateway operations; not accepted by Console-only operations. 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
cwd
string
required

Working directory

id
string
required

Agent ID

allowRuntimeMismatch
boolean

Allow mutation even when the CLI bundle differs from the live daemon runtime

model
string

Runtime model selector

modelPreset
string

Reference a runtime model preset (mutually exclusive with --model)

provider
string

Runtime provider id

Response

Success — body conforms to the @Returns schema.

action
string
required
Allowed value: "create"
agent
object
required
changed
boolean
required
permissions
object
required
runtimeTarget
object
required
{key}
any