Delete a product swap automation

Permanently deletes a product swap automation configuration. Once deleted, the swap will no longer be applied to any subscription orders. Existing subscriptions that have already had products swapped are not affected.

Full behavior, validation rules, and side effects

Deletion Behavior:

• Permanently removes the swap automation
• Does not reverse past swaps that have already occurred
• Future orders will not have this swap applied
• Cannot be undone - swap configuration must be recreated if needed

Impact on Subscriptions:

• Active Subscriptions: Will continue with current products (no automatic reversion)
• Future Orders: Swap will not be applied
• Past Orders: Already swapped products remain unchanged
• Queued Swaps: Pending swaps for this automation are cancelled

When to Delete:

• Discontinuing a seasonal product rotation
• Removing outdated swap rules
• Cleaning up test or experimental swaps
• Product lines being discontinued
• Correcting misconfigured swaps

Important Notes:

• This operation is permanent and cannot be undone
• Consider deactivating instead of deleting if you might reuse the configuration
• Activity logs for past swaps are retained
• Customers are not automatically notified of swap deletion

Best Practices:

• Review affected subscriptions before deletion
• Consider communicating changes to affected customers
• Export swap configuration if you might need it later
• Use deactivation for temporary pauses instead of deletion

Authentication: Requires valid X-API-Key header

DELETE /api/external/v2/product-swaps/{id}

Delete a product swap automation

cURL

curl --request DELETE \
  --url https://subscription-admin.appstle.com/api/external/v2/product-swaps/{id}

400

{
  "type": "https://example.com/errors/bad-request",
  "title": "Invalid id",
  "status": 400,
  "detail": "Product swap does not belong to this shop or ID is invalid"
}

Headers

X-API-Key · string

Path Parameters

id · integer<int64> · required

Response

204

Product swap successfully deleted - No content returned