Skip to content
Warp

Factories

budget_exceeded

Your team's configured spending budget limit has been reached. Increase the budget or wait for the budget period to reset.

Open in ChatGPT ↗
Ask ChatGPT about this page
Open in Claude ↗
Ask Claude about this page
Copied!

The budget_exceeded error occurs when your team has reached the spending budget limit configured in team settings.

Details

Section titled “Details”
  • HTTP Status: 403 Forbidden
  • Retryable: No
  • Task State: FAILED

When does this occur?

Section titled “When does this occur?”

This error is returned when:

  • Your team has set a spending budget cap, and the current period’s usage has reached that cap
  • A cloud agent task, scheduled run, or integration-triggered run attempts to start but would exceed the budget

The title field in the response will describe the specific budget constraint.

Example response

Section titled “Example response”
{
  "type": "/factories/api-and-sdk/troubleshooting/errors/budget-exceeded/",
  "title": "Monthly spending budget of $50 has been reached.",
  "status": 403,
  "instance": "/api/v1/agent/tasks",
  "error": "Monthly spending budget of $50 has been reached.",
  "retryable": false
}

How to resolve

Section titled “How to resolve”
  1. Go to your team settings and increase the spending budget, or
  2. Wait for the budget period to reset (for example, at the start of the next billing cycle).

If you are not a team admin, contact your team admin to adjust the budget.

Section titled “Related”