Skip to main content
POST
Create a new agent

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
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

provider
string

Runtime provider id

Response

Success — no @Returns schema declared; payload shape is loose.

The response is of type object.