---
title: "Delete Billing Config"
method: DELETE
path: "/v1/admin/billing-configs/{config_id}"
---

# Delete Billing Config

`DELETE /v1/admin/billing-configs/{config_id}`

Delete a config outright — scheduled, current, or past.

Deleting a period that has already started rewrites revenue history (the
Revenue tab attributes billing events from these rows), so it is meant for
rows that should never have existed: a prospect who backed out before
signing, or a mis-entered period. To *stop* billing a real customer while
keeping their history, PATCH ``effective_until`` instead of deleting.

By default the adjacent earlier period ending exactly at this config's
effective_from is reopened (effective_until back to NULL), undoing the
auto-close from creation — unless reopening would overlap another period.

## Path parameters

- `config_id` string, uuid, required

## Query parameters

- `reopen_previous` boolean — Reopen the period that was auto-closed at this config's start date

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/shortkit/apis/shortkit-api.md) · [All operations](https://skmtc.net/shortkit/apis/shortkit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shortkit/shortkit-api/versions/4ff6d068cf75/schema)
