Skip to main content
POST
Update an agent installed from the Library to the latest version. Requires --execute when it raises the 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
id
string
required

Local agent id

execute
boolean

Confirm a higher permission profile or new skill grants (without it, print the plan and exit 3)

keepLocal
boolean

Keep files edited here that also changed in the Library

takeLibrary
boolean

Replace files edited here with the Library version

Response

Success — body conforms to the @Returns schema.

agent
string
required
granted
string[]
required
kept
string[]
required
plan
object
required
previousVersion
number
required
profile
string | null
required
ref
string
required
success
boolean
required
upToDate
boolean
required
version
number
required
written
string[]
required