v1

latestOpenAPI 3.0.1MIT2026-07-263151,3912.3 MB

Tier Structures

Delete tier

<Badge color="yellow">BETA endpoint</Badge>

This is a work-in-progress documentation of a BETA endpoint. The parameters, fields, request and response bodies, and other data may subject to change. If you want to share feedback or improvements, contact Voucherify support or your Technical Account Manager.

</Warning>

Deletes a tier from the tier structure and returns the deleted resource.

delete/v2/loyalties/tier-structures/{tierStructureId}/tiers/{tierId}

Path parameters

idstring required

Unique tier structure identifier.

tierIdstring required

Unique tier identifier.

Response

The deleted tier.

idstring required

Unique tier identifier.

tier_structure_idstring required

Identifier of the parent tier structure.

namestring required

Display name of the tier.

metadataobject required

Free-form key/value object holding custom attributes. Defaults to {}.

created_atstring date-time required

Creation timestamp (ISO 8601).

updated_atstring date-time required

Last update timestamp (ISO 8601), or null if never updated.

objectstring required

Object type discriminator. Always tier.