latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-101025471.3 MB

69be73b5cff0

Tier Structures

Update tier

<Info>

<Badge color="gray">Documentation in progress</Badge>

This documentation is in progress. The parameters, fields, request and response bodies, and other data may be subject to change. If you need more information or you want to share feedback, contact Voucherify support or your Technical Account Manager.

</Info>

Updates a tier within the tier structure. All properties are optional. When the parent tier structure is not in DRAFT status, only name and metadata may be updated.

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

Path parameters

idstring required

Unique tier structure identifier.

tierIdstring required

Unique tier identifier.

Request body

namestring

Display name of the tier.

metadataobject nullable

Free-form key/value object holding custom attributes.

Response

The updated tier.

idstring required

Unique tier identifier.

tier_structure_idstring required

Unique 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 nullable required

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

object'tier' required

Object type discriminator. Always tier.