Skip to main content
POST
/
v1
/
budgets
/
requests
Submit a budget increase request
curl --request POST \
  --url https://api.example.com/v1/budgets/requests \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "virtualKeyId": "<string>",
  "fromUsd": 20,
  "toUsd": 50,
  "reason": "Need more budget for Q2 analysis job",
  "durationHours": 24
}
'

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
virtualKeyId
string
required
​
fromUsd
number
required
Example:

20

​
toUsd
number
required
Example:

50

​
reason
string
required
Example:

"Need more budget for Q2 analysis job"

​
durationHours
number

How long (hours) the elevated budget is needed. On approve the budget auto-reverts after this window. Default 24, max 720.

Example:

24

Response

201 - undefined