Delete a budget for a scope

Permanently removes the budget for the {scope} path segment — account, or a key/agent budget's scopeId — and returns 204 No Content with an empty body.

Endpoint

DELETE https://api.dairo.app/v1/budgets/{scope}

Permanently removes the budget for the {scope} path segment — account, or a key/agent budget's scopeId — and returns 204 No Content with an empty body. Enforcement stops immediately: the scope keeps no ceiling and its sends are no longer gated by this budget. Deleting a budget that does not exist returns 404. Requires the budgets:write scope.

Scope: budgets:write. Send the API key as a bearer token; Scopes lists what each one reaches.

Request

cURL

curl -X DELETE "https://api.dairo.app/v1/budgets/account" \
  -H "Authorization: Bearer $DAIRO_API_KEY"

Path parameters

Name	Type	Required	Description
`scope`	string	yes

Response

200 Success. Body: application/json, ErrorResponse.

Field	Type	Required	Description
`error`	Error	yes

200

{
  "error": {
    "message": "string",
    "code": "string",
    "type": null,
    "param": null
  }
}

Errors

Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.

Status	Meaning
`400`	The request is malformed or a value is invalid (`invalid_request`, `invalid_domain`, `idempotency_key_mismatch`).
`401`	The API key is missing or invalid.
`403`	The key lacks the scope this endpoint needs (`scope_missing`) or may not do this (`not_permitted`).
`404`	No such resource in this account (`resource_not_found`).
`429`	Rate limit, plan limit, budget or spend cap reached (`rate_limited`, `plan_limit_reached`, `budget_exceeded`, `spend_cap_reached`).
`500`	An unexpected error; retry with backoff, then contact support (`internal_error`).

Delete a budget for a scope

Request

Path parameters

Response

Errors

On this page