# Read the builder's limits

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

`GET /v1/builder/settings` · scope `workspace:read`

The three limits of the builder and of test runs: `monthlyLimitUsd` (the builder pauses when the month's use reaches it), `testRunLimitUsd` (one test chat, or one conversation of a simulation, stops when it reaches it, with the stop `test_run_limit_reached` on the run) and `maxSteps` (how many things the builder does before it replies). `sources` names the layer that decided each (`platform`, `plan` or `workspace`), `defaults` what each returns to, and `bounds` the most and least each accepts here. Any member of the workspace may read them.

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

## Request

cURL:

```bash
curl https://api.vlayers.ai/v1/builder/settings \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

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

const voicelayer = new VoiceLayer();

const { testRunLimitUsd } = await voicelayer.hosting.getBuilderSettings();
console.log(testRunLimitUsd);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.hosting.get_builder_settings()
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
}
```
