DELETE/api/orgs/{org_id}/budgets/{budget_id}

Delete a budget

Removes the cap (back to unlimited); this is the only way to lift a 0 cap. Provisioning key only; a key may delete only identity and key budgets its own key authored, never the default identity's.

Authentication: Bearer API key in the Authorization header

Path parameters

  • org_idstringrequired

    Your organization id (uuid). GET /api/whoami returns it.

  • budget_idstringrequired

    Budget id.

Responses

  • 200

    Deleted.

    Response
    • deletedbooleanrequired
  • 401

    Missing, unknown or revoked API key.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 403

    Not a provisioning key, a scope a key may not delete, the default identity, or a row authored elsewhere.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

  • 404

    Unknown budget.

    Response
    • errorstringrequired

      Human-readable message.

    • codestring

      Stable machine reason, when the route defines one (for example pro_required).

    • actionstring

      Stable remediation action, when the route defines one.

    • detailsobject

      Customer-safe string facts the caller needs to act (for example a suggested identifier).

Request

curl -X DELETE https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/budgets/b7e1c0d2-5a4f-4c39-8e16-2d9f0a7b3c51 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "deleted": true
}

https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/budgets/b7e1c0d2-5a4f-4c39-8e16-2d9f0a7b3c51