Coupons

Delete a coupon

curl -X DELETE https://api.subscriby.net/v1/projects/7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13/coupons/4b9d3e08-a1f6-4275-9c83-7e01d6a2f594 \
  -H "Authorization: Bearer sbt_..." \
  -H "Idempotency-Key: $(uuidgen)"

Removes the code and its redemption history; deactivating keeps both. Answers 204 with no body.

A delete can be refused. If any subscriber holds a live reservation, a checkout in flight with this discount already quoted to a payment provider, the delete answers 422 and asks you to deactivate instead.

delete/v1/projects/{project}/coupons/{coupon}

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/projects/{project}/coupons/{coupon}
  • Auth: HTTP bearer

Path parameters

projectstring uuid required

The project, resolved by the route binder.

couponstring uuid required

The coupon, resolved within the project by the route binder.

Headers

Idempotency-Keystring uuid required

A key unique to this operation, such as a fresh UUID. The same key replays the original 2xx response for 24 hours (with Idempotent-Replay: true), so a retry after a timeout never repeats the write; the same key with a different body is refused with 409.

Response

No content

Changes

No recorded changes to this operation across all 1 revision of this API.