Change the builder's limits

PUT
/v1/builder/settings

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.

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.

Request Body

application/json
  1. body
monthlyLimitUsd?|

The most the builder may cost in a calendar month, US dollars. null: the default.

Range0 <= value
testRunLimitUsd?|

The most one test run may spend, US dollars. null: the default.

Range0.01 <= value
maxSteps?|

Steps the builder takes before it replies, 4 to 40. null: the default.

Range4 <= value <= 40
expectedVersion?integer

The version you read.

Range0 <= value

Response Body

The limits after the change

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 -X PUT https://api.vlayers.ai/v1/builder/settings \  -H "Authorization: Bearer $VOICELAYER_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "testRunLimitUsd": 1  }'
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}