Skip to main content
POST
Delete an 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
id
string
required

Agent ID

execute
boolean

Actually delete the agent; default is a dry-run that only shows the plan (exit 3)

Response

Success — body conforms to the @Returns schema.

action
string
required
Allowed value: "delete"
agentId
string
required
changed
boolean
required
before
object
{key}
any