Time	Status	User Agent
Retrieving recent requests…

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.

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 DRAFT status.

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.

Example response

A successful delete returns HTTP 204 with an empty body.

Response parameters

Field	Type	Description
—	—	The response body is empty on success (HTTP 204 No Content).

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 999999 with a descriptive message on the wire.