Skip to main content
POST
Set or inspect an agent's generic model-broker profile

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

Agent ID

broker
string

Registered model-broker ID

clear
boolean

Remove this agent's model-broker selection

execute
boolean

Apply a required broker selection after capability preflight

profile
string

Opaque public profile reference owned by the broker

required
string

Require broker routing (true or false)

Response

Success — body conforms to the @Returns schema.

action
string
required
Allowed value: "model-broker"
agentId
string
required
changed
boolean
required
modelBroker
object | null
required
agent
object
defaults
object | null