Sets a workspace preset to Auto or a selected active text model.

PUT

https://api.awork.com/api/v1/agents/models/settings/presets/:presetKey

Required Permissions

The user must be an admin or have workspace-manage-config:write permissions.

Updates a workspace model preset to use central Auto selection or an explicit active text model. Identify the preset by its catalog key and provide the assignment in the request body. Returns no content when the assignment is saved, or a validation error if the selection is invalid. <Check title="Required Permissions" icon="key">The user must be an admin or have `workspace-manage-config:write` permissions.</Check>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

presetKeystringRequired

The preset key.

Request

The preset assignment.

isAutobooleanOptional

Whether the preset uses the central Auto mapping.

modelKeystring or nullOptional

The explicit model key when Auto is false.

reasoningLevelstring or nullOptional

The explicit reasoning level when Auto is false.

Response

No Content

Errors

400

Bad Request Error

401

Unauthorized Error