Skip to main content
POST
Set agents' default model

Authorizations

Authorization
string
header
required

Workspace API key (wk_). GET endpoints require the Workspace read API scope, POST endpoints the Workspace write API scope.

Body

application/json
ids
string[]
required

Agent IDs to update.

Minimum array length: 1
model
string | null
required

Model or model-alias ID to use as each agent's default, or null to inherit the workspace default.

Response

Success. Empty result sets are also 200.

Batch outcome. The request is 200 as long as it was well-formed; check per-id success for failures.

results
object[]
required
summary
object
required