Change the builder's limits
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.
apiKeyAuthorizationBearer <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.
application/json- body
monthlyLimitUsd?|The most the builder may cost in a calendar month, US dollars. null: the default.
0 <= valuetestRunLimitUsd?|The most one test run may spend, US dollars. null: the default.
0.01 <= valuemaxSteps?|Steps the builder takes before it replies, 4 to 40. null: the default.
4 <= value <= 40expectedVersion?integerThe version you read.
0 <= valueThe limits after the change
application/json- response
monthlyLimitUsd*numberThe most the builder's model use may cost the workspace in a calendar month, US dollars
0 <= valuetestRunLimitUsd*numberThe most one test run may spend, US dollars
0.01 <= valuemaxSteps*integerHow many things the builder may do before it replies
4 <= value <= 40sources*Which layer decided each value
defaults*What each value returns to without the workspace's own
bounds*version*integerPass back as expectedVersion
0 <= valuecurl -X PUT https://api.vlayers.ai/v1/builder/settings \ -H "Authorization: Bearer $VOICELAYER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "testRunLimitUsd": 1 }'{ "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}