Skip to main content
POST
Set session runtime provider override

Body

application/json
nameOrKey
string
required

Session name or key

provider
string
required

Runtime provider id (codex, claude, pi, grok) or 'clear' to remove override

propagate
boolean

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

Response

Success — body conforms to the @Returns schema.

action
string
required
Allowed value: "set-provider"
after
object | null
required
appliesOn
string
required
Allowed value: "next-turn-runtime-restart"
before
object
required
changed
boolean
required
effectiveProvider
string
required
providerSource
string
required
runtimeProviderOverride
string | null
required
sessionKey
string
required
sessionName
string | null
required
agentDefaultDiffers
boolean
agentDefaultModel
string | null
agentDefaultProvider
string | null
hint
string | null
propagateCommand
string | null
propagated
boolean
rematerializedSessions
object[]