Skip to main content
POST
Set session model override

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

Model name (sonnet, opus, haiku) or 'clear' to remove override

nameOrKey
string
required

Session name or key

propagate
boolean

Also set the agent default model and rematerialize sibling sessions without overrides

Response

Success — body conforms to the @Returns schema.

action
string
required
Allowed value: "set-model"
after
object | null
required
before
object
required
changed
boolean
required
effectiveModel
string
required
modelOverride
string | null
required
sessionKey
string
required
sessionName
string | null
required
agentDefaultDiffers
boolean
agentDefaultModel
string | null
agentDefaultProvider
string | null
event
object
hint
string | null
notification
object
propagateCommand
string | null
propagated
boolean
rematerializedSessions
object[]