> ## Documentation Index > Fetch the complete documentation index at: https://docs.voucherify.io/llms.txt > Use this file to discover all available pages before exploring further. # Update Tier > ⚠️ **BETA endpoint** 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. Updates an existing tier. All fields are optional; omitted fields retain their current values. The tier must belong to the specified tier structure. When changing `qualification_rules.type` to `POINTS`, `min_value` is required and the new point range must not overlap with other tiers. When changing to `SEGMENT`, `segment.id` is required. ## OpenAPI ````yaml /openapi/loyalties-v2.json put /v2/loyalties/tier-structures/{id}/tiers/{tierId} openapi: 3.1.0 info: title: Voucherify Loyalty v2 API version: 2.0.0 description: >- Complete API documentation for Voucherify Loyalty v2 system. Requires LOYALTY_V2 feature flag. servers: - url: https://api.voucherify.io description: Production security: - bearerAuth: [] X-App-Id: [] X-App-Token: [] tags: - name: Card Definitions description: >- CRUD operations, lifecycle management, and activity history for card definitions. Card definitions describe the configuration for loyalty cards, including code generation, points expiration, earning/spending limits, pending points, refunds, and balance settings. - name: Programs description: >- Loyalty program CRUD, lifecycle management, program-scoped resource assignments (card definitions, earning rules, rewards, tier structures), member management (create, list, get, activate, deactivate, delete), card operations (points adjustment, pending points, expiring points, transactions), reward purchases, and activity history. - name: Earning Rules description: >- Manage earning rules that define how customers earn points or receive incentives based on triggers (events, segments, custom events). Includes CRUD, lifecycle, and activity history. - name: Tier Structures description: >- CRUD operations, lifecycle management, and activity history for tier structures. Includes nested tier definitions (create, list, update, delete) within tier structures. Tier structures define the tiering model for loyalty programs — how members qualify for and move between tiers. - name: Incentives description: >- Manage incentive definitions (fixed points, proportional points, material, digital). Includes CRUD, lifecycle transitions, and activity history. - name: Rewards description: >- CRUD, lifecycle operations, and activity history for reward definitions. Rewards can be material (product/SKU) or digital (discount coupons, gift vouchers). - name: Examine description: Examines the earning of loyalty points for a loyalty program member. paths: /v2/loyalties/tier-structures/{id}/tiers/{tierId}: parameters: - $ref: '#/components/parameters/TierStructureId' - $ref: '#/components/parameters/TierId' put: tags: - Tier Structures summary: Update Tier description: > ⚠️ **BETA endpoint** 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. Updates an existing tier. All fields are optional; omitted fields retain their current values. The tier must belong to the specified tier structure. When changing `qualification_rules.type` to `POINTS`, `min_value` is required and the new point range must not overlap with other tiers. When changing to `SEGMENT`, `segment.id` is required. operationId: updateTier requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TierUpdateRequest' responses: '200': description: Updated tier content: application/json: schema: $ref: '#/components/schemas/Tier' '400': $ref: '#/components/responses/BadRequest' '403': description: Tier overlaps with an existing tier's point range. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' components: parameters: TierStructureId: name: id in: path required: true schema: type: string description: Unique tier structure identifier. TierId: name: tierId in: path required: true schema: type: string description: Unique tier identifier. schemas: TierUpdateRequest: type: object description: All fields optional. Omitted fields retain their current values. properties: name: type: string minLength: 1 maxLength: 200 description: Display name. qualification_rules: oneOf: - $ref: '#/components/schemas/TierQualificationRulesRequest' - type: 'null' description: Qualification rules. downgrade: oneOf: - $ref: '#/components/schemas/TierDowngradeRequest' - type: 'null' description: Downgrade override. metadata: oneOf: - type: object additionalProperties: true - type: 'null' description: Custom key-value metadata. additionalProperties: false Tier: type: object description: A tier resource as returned by the API. properties: id: type: string description: Unique tier identifier. tier_structure_id: type: string description: ID of the parent tier structure. name: type: string maxLength: 200 description: Display name. qualification_rules: oneOf: - $ref: '#/components/schemas/TierQualificationRules' - type: 'null' description: Rules determining how members qualify for this tier. downgrade: $ref: '#/components/schemas/TierDowngrade' metadata: type: object description: Custom key-value metadata. additionalProperties: true created_at: type: string format: date-time description: ISO 8601 creation timestamp. updated_at: oneOf: - type: string format: date-time - type: 'null' description: ISO 8601 last-update timestamp. object: type: string enum: - tier description: Object type discriminator. required: - id - tier_structure_id - name - downgrade - metadata - created_at - object ErrorResponse: type: object description: Standard error response. properties: code: type: integer description: HTTP status code. key: type: string description: Machine-readable error key. message: type: string description: Human-readable error message. details: type: string description: Additional error details. request_id: type: - string - 'null' description: Request identifier for tracing. resource_id: type: string description: Related resource identifier (when applicable). resource_type: type: string description: Related resource type (when applicable). required: - code - key - message TierQualificationRulesRequest: type: object description: > When `type` is `POINTS`, `min_value` is required. `max_value` is optional but if provided must be >= `min_value`. Cannot have `max_value` without `min_value`. When `type` is `SEGMENT`, `segment` is required and `min_value`/`max_value` are not allowed. properties: type: type: string enum: - POINTS - SEGMENT min_value: type: integer minimum: 0 description: Minimum point value for tier qualification. max_value: type: integer minimum: 0 description: Maximum point value. Must be >= min_value. segment: oneOf: - $ref: '#/components/schemas/TierQualificationRulesSegmentRequest' - type: 'null' description: Segment reference. Required when `type` is `SEGMENT`. required: - type additionalProperties: false TierDowngradeRequest: type: object properties: type: type: string enum: - INHERIT - NO_DOWNGRADE description: '`INHERIT` uses the tier structure''s downgrade setting.' required: - type additionalProperties: false TierQualificationRules: type: object description: > When `type` is `POINTS`, `min_value` is required and defines the point threshold. `max_value` is optional (open-ended tier if omitted). When `type` is `SEGMENT`, `segment` is required. properties: type: type: string enum: - POINTS - SEGMENT min_value: oneOf: - type: integer minimum: 0 - type: 'null' description: Minimum point value for tier qualification. max_value: oneOf: - type: integer minimum: 0 - type: 'null' description: Maximum point value for tier qualification. segment: oneOf: - $ref: '#/components/schemas/TierQualificationRulesSegment' - type: 'null' description: Segment reference. Present when `type` is `SEGMENT`. required: - type TierDowngrade: type: object properties: type: type: string enum: - INHERIT - NO_DOWNGRADE description: >- `INHERIT` uses the tier structure's downgrade setting. `NO_DOWNGRADE` disables downgrade for this tier. TierQualificationRulesSegmentRequest: type: object properties: id: type: string description: Segment identifier. required: - id additionalProperties: false TierQualificationRulesSegment: type: object properties: id: type: string description: Segment identifier. required: - id responses: BadRequest: description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT X-App-Id: type: apiKey name: X-App-Id in: header X-App-Token: type: apiKey name: X-App-Token in: header ````