Skip to main content
POST
Create a local agent from a Library agent definition. Requires --execute when it raises the permission profile or grants skills.

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
ref
string
required

Library agent ref: org/ or /

cwd
string

Agent folder (default: ~/ravi/)

execute
boolean

Confirm a profile above the bootstrap floor or skill grants (without it, print the plan and exit 3)

id
string

Local agent id (default: the ref's slug)

Response

Success — body conforms to the @Returns schema.

agent
object
required
granted
string[]
required
next
string[]
required
profile
string | null
required
ref
string
required
skipped
object[]
required
success
boolean
required
version
number
required