insufficient_credits

The insufficient_credits error occurs when your team has no remaining Add-on Credits to run cloud agents or integrations.

---

Details

• HTTP Status: 403 Forbidden
• Retryable: No
• Task State: FAILED

---

When does this occur?

This error is returned when:

• Your team’s Add-on Credits balance has reached zero
• A cloud agent task, scheduled run, or integration-triggered run (Slack, Linear) attempts to start but cannot be billed

Cloud agent runs consume credits based on usage. When credits are depleted, no new runs can start until credits are replenished.

---

Example response

{
  "type": "/reference/api-and-sdk/troubleshooting/errors/insufficient-credits/",
  "title": "Your team has run out of Add-on Credits. Purchase more credits in your team's billing settings to continue.",
  "status": 403,
  "instance": "/api/v1/agent/tasks",
  "title": "Your team has run out of add-on credits. Purchase more credits in your team's billing settings to continue.",
  "status": 403,
  "instance": "/api/v1/agent/tasks",
  "error": "Your team has run out of add-on credits. Purchase more credits in your team's billing settings to continue.",
  "retryable": false
}

---

How to resolve

1. Go to your team’s billing settings in the Oz web app or Warp desktop app.
2. Purchase additional Add-on Credits.
3. Retry the failed operation.

If you are not a team admin, contact your team admin to purchase credits.

---

Related

• Access, Billing, and Identity — Credit billing and plan requirements
• Cloud Agents Overview — Billing and plan requirements for cloud agents