Skip to main content
POST
Reset agent session

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 reset the session(s); default is a dry-run that only shows the plan (exit 3)

nameOrKey
string

Session name/key, 'all' to reset all, or omit for main

Response

Success — body conforms to the @Returns schema.

action
string
required
Allowed value: "reset"
agentId
string
required
changed
boolean
required
target
string
required
availableSessions
string[]
count
number
reason
string
resetSessions
object[]
session
object
{key}
any