# Change the builder's limits

Source: https://docs.vlayers.ai/reference/hosting/update-builder-settings

`PUT /v1/builder/settings` · scope `workspace:write`

Sets any of the three limits for the workspace; `null` returns one to the default. Only an Admin of the workspace may (a member, and the builder itself, are refused). A value outside `bounds` answers 422 with the bound and why it exists. Every change is recorded in the access log with who made it and the old and new values. Pass `expectedVersion` from the read to avoid overwriting someone else's change (409).

Requires an API key with the `workspace:write` scope.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `monthlyLimitUsd` | body | number | no | The most the builder may cost in a calendar month, US dollars. `null`: the default. |
| `testRunLimitUsd` | body | number | no | The most one test run may spend, US dollars. `null`: the default. |
| `maxSteps` | body | integer | no | Steps the builder takes before it replies, 4 to 40. `null`: the default. |
| `expectedVersion` | body | integer | no | The `version` you read. |

## Request

cURL:

```bash
curl -X PUT https://api.vlayers.ai/v1/builder/settings \
  -H "Authorization: Bearer $VOICELAYER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "testRunLimitUsd": 1
  }'
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { testRunLimitUsd } = await voicelayer.hosting.updateBuilderSettings({ testRunLimitUsd: 1 });
console.log(testRunLimitUsd);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.hosting.update_builder_settings(test_run_limit_usd=1)
print(result.test_run_limit_usd)
```

## Response `200`

```json
{
  "monthlyLimitUsd": 25,
  "testRunLimitUsd": 0.5,
  "maxSteps": 16,
  "sources": {
    "monthlyLimitUsd": "workspace",
    "testRunLimitUsd": "platform",
    "maxSteps": "platform"
  },
  "defaults": {
    "monthlyLimitUsd": 10,
    "testRunLimitUsd": 0.5,
    "maxSteps": 16
  },
  "bounds": {
    "monthlyLimitUsd": {
      "min": 0,
      "max": 1000
    },
    "testRunLimitUsd": {
      "min": 0.01,
      "max": 25
    },
    "maxSteps": {
      "min": 4,
      "max": 40
    }
  },
  "version": 1
}
```
