v3

latestOpenAPI 3.1.02026-08-0712650111.6 KB

Delete Billing Config

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.

delete/v1/admin/billing-configs/{config_id}

Path parameters

config_idstring uuid required

Query parameters

reopen_previousboolean

Reopen the period that was auto-closed at this config's start date

Reopen the period that was auto-closed at this config's start date

Response

Successful Response

{"stackTrail":"paths:/v1/admin/billing-configs/{config_id}:delete:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}