delete
https://{Host}/v3/tiers/
Soft-delete a DRAFT tier.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Delete Tier
Soft-deletes a DRAFT tier by setting its status to DELETED. Only tiers in DRAFT status can be deleted. Published (ACTIVE or LIVE) tiers and tiers pending approval can't be removed with this endpoint.
Deletion is a soft-delete — the tier record is retained in the system but its status is set toDELETED. A deleted tier is no longer retrievable via Get Tier or List All Tiers. It cannot be edited, reactivated, or submitted for approval.
Example request
curl -X DELETE "https://eu.intouch.capillarytech.com/v3/tiers/6a2121936497e74ec3517ad8" \
-H "Authorization: Basic <base64-encoded-credentials>"Prerequisites
- Authentication: Basic auth or OAuth token with loyalty program management permissions.
- The tier must be in
DRAFTstatus.
Resource information
| Pagination support | No |
| Batch support | No |
Path parameters
| Field | Type | Required | Description |
|---|---|---|---|
tierId | string | Required | The objectId of the draft tier, from the Create Tier response. The tierUniqueId and slabId are not accepted on this endpoint. |
Response
HTTP 204 No Content. The response body is empty on success.
Error and warning codes
| Code | Error number | Type | Description |
|---|---|---|---|
TIER.NOT_FOUND | 9056 | Error | No tier matches the given tierId. HTTP 404. |
TIER_NOT_DELETABLE_NON_DRAFT | — | Error | The tier is not in DRAFT status. Only DRAFT tiers can be deleted. HTTP 409. |
Note: Conflict errors (HTTP 409) return the generic error number
999999with a descriptive message on the wire.
Tier deleted. No response body.
Tier not found (error 9056)
Status conflict: only DRAFT tiers can be deleted