---
title: "POST /v1/balances.delete"
method: POST
path: "/v1/balances.delete"
tags: ["balances"]
---

# POST /v1/balances.delete

`POST /v1/balances.delete`

Delete a balance for a customer feature. Can only delete a balance that is not attached to a price (eg. you cannot delete messages that have an overage price).

## Headers

- `x-api-version` string, required

## Request body

- object
  - `customer_id` string, required — The ID of the customer.
  - `entity_id` string — The ID of the entity.
  - `feature_id` string — The ID of the feature.
  - `balance_id` string — The ID of the balance to delete.
  - `recalculate_balances` boolean — If true, deduct the deleted balance's remaining amount from the customer's other balances for the same feature after deletion.
  - `interval` 'one_off' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'semi_annual' | 'year' — Target a specific balance by its reset interval. Use when the customer has multiple balances for the same feature with different reset intervals.

## Response `200`

OK

- object
  - `success` boolean, required

---

[API](https://skmtc.net/useautumn/apis/autumn-api.md) · [All operations](https://skmtc.net/useautumn/apis/autumn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/useautumn/autumn-api/revisions/29536933c0dc/schema)