Detach a promotion from a plan
Detaches the promotion from the plan. New carts on the plan stop receiving the discount; subscriptions that already captured it keep their terms.
Admins and Developers can obtain their Bolt API key from the Bolt Merchant Dashboard. Send it together with X-Publishable-Key.
In: header
Path Parameters
ID of the plan.
ID of the promotion to detach.
Response Body
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/subscriptions/plans/spl_ba_PpkW16oIW/promotions/bcp_V9y3q4Jw8kQe"{ "id": "bcp_V9y3q4Jw8kQe", "name": "Launch discount", "status": "active", "target": "item", "automatic": true, "combinable": true, "priority": 0, "duration": "once", "percent_off": 0, "amount_off": 0, "currency": "USD", "minimum_amount": 0, "allowed_cycle_counts": 0, "max_redemptions": 0, "times_redeemed": 0, "allowed_customers": [ "string" ], "plan_ids": [ "string" ], "codes": [ { "id": "string", "code": "LAUNCH20", "active": true, "max_redemptions": 0, "times_redeemed": 0, "expires_at": "2019-08-24T14:15:22Z", "first_time_transaction": true } ], "redeem_by": "2019-08-24T14:15:22Z", "activated_at": "2019-08-24T14:15:22Z", "deactivated_at": "2019-08-24T14:15:22Z"}Attach a promotion to a plan POST
Attaches a promotion of the plan's product to the plan. The discount applies to new carts on that plan; running subscriptions are not re-priced. Catalog divisions only.
List a product's promotions GET
Retrieves the promotions on this product's plans, along with the division's cart promotions.