Read the builder's limits

GET
/v1/builder/settings

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.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Response Body

The builder's limits now, which layer set each, what the defaults are and the most each accepts

application/json
  1. response
monthlyLimitUsd*number

The most the builder's model use may cost the workspace in a calendar month, US dollars

Range0 <= value
testRunLimitUsd*number

The most one test run may spend, US dollars

Range0.01 <= value
maxSteps*integer

How many things the builder may do before it replies

Range4 <= value <= 40
sources*

Which layer decided each value

defaults*

What each value returns to without the workspace's own

bounds*
version*integer

Pass back as expectedVersion

Range0 <= value
Example Request
curl https://api.vlayers.ai/v1/builder/settings \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "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}