POST /v1/budgets
BillingService_CreateBudgetPool
The server validates credentials, tenant, environment and permissions. This page does not send requests. Replace example values; deployed server validation remains authoritative.
Parameters
No path or query parameters.
Request body
codestringcurrencystringenforcementstringidempotency_keystringlimit_amountstringnamestringperiod_ends_atstringperiod_kindstringperiod_starts_atstringscopestringscope_ref_idstring
cURL
curl --request POST 'https://nexus-api.rainlib.com/v1/budgets' \
--header 'Authorization: Bearer <NEXUS_ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
"code": "<value>",
"currency": "<value>",
"enforcement": "<value>",
"idempotency_key": "<value>",
"limit_amount": "<value>",
"name": "<value>",
"period_ends_at": "<value>",
"period_kind": "<value>",
"period_starts_at": "<value>",
"scope": "<value>",
"scope_ref_id": "<value>"
}'Response contract
200 · OK
codestringconsumed_amountstringcurrencystringenforcementstringidstringlimit_amountstringnamestringperiod_ends_atstringperiod_kindstringperiod_starts_atstringreserved_amountstringscopestringscope_ref_idstringstatusstringupdated_atstringversionstring
Generated responses do not enumerate every runtime error. See the integration guide for authentication, conflicts and retries.