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, PUT, PATCH and DELETE 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 for the one a new agent gets (workspace default, else platform 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