# Agents assistant settings set

`PUT /agents/assistant/settings` · Rivier · agents

Choose the model the assistant plans with for this organisation, or null for the platform default. If the plan does not include it the assistant falls back to the default.

- Scope: agents:write
- Sdk: agents.assistant.settingsSet
- Cli: agents assistant settings set

## Request body

`application/json`

```json
{
  "type": "object",
  "properties": {
    "modelId": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "modelId"
  ],
  "additionalProperties": false
}
```

## Responses

- `200`: Success
- `400`: The request was malformed
- `401`: No valid credential
- `403`: The credential lacks the scope, origin or address
- `429`: Over the key's rate limit; see Retry-After

## Example

```sh
curl -X PUT 'https://api.rivier.ai/agents/assistant/settings' \
  -H 'Authorization: Bearer $KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "modelId": "string"
}'
```