PUT
Create or replace the session model override

Authorizations

Authorization
string
header
required

An opaque BMA personal or organization bearer token.

Path Parameters

orgID
string
required

Organization ID (org_...).

Pattern: ^org_[a-z2-7]{26}$
projectID
string
required

Project ID (proj_...).

Pattern: ^proj_[a-z2-7]{26}$
agentID
string
required

Agent ID (agt_...).

Pattern: ^agt_[a-z2-7]{26}$

Body

application/json
model
string
required

Provider model slug (for example deepseek-flash).

Required string length: 1 - 200
provider
object
api_key
string
write-only

Write-only. Never returned, logged, or emitted; encrypted at rest.

Required string length: 8 - 4096
ttl_seconds
integer
default:3600
Required range: 300 <= x <= 86400
expires_with_session
boolean
default:false

Keep the override active until the session is archived instead of a TTL.

Response

Override active for the next turn.

model_override
object
required