Permanently delete a product group. Products within the group are not affected.
POST /v1/actions/subscription-product-group/delete-group
Request Body
| Field | Type | Required | Description |
|---|
id | string | Yes | Group ID (UUID format) |
Example Request
await client.subscriptionProductGroups.delete({
id: "d4e5f6a7-b8c9-0d1e-2f3a-4b5c6d7e8f9a",
});
This is a permanent hard delete. The products within the group are not deleted — only the grouping relationship is removed.
Errors
Retry policy: Never retry 4xx — fix the request and resubmit. Retry 5xx with exponential backoff (start 5s, max 3 attempts).
| Status | errors[0].message | What it means | Recommended handling |
|---|
| 400 | Missing required field: id | Request body did not include id | Add id, resubmit |
| 404 | Group not found | The group is already gone or never belonged to your store | Verify the id |
| 500 | Internal server error | Internal error or transient downstream failure | Retry with exponential backoff (start 5s, max 3 attempts) |
