v1

latestOpenAPI 3.0.1MIT2026-07-263151,3912.3 MB
Benefits

Move benefit to draft

<Warning>

<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>

Moves a benefit from ACTIVE back to DRAFT status. No request body. Only the ACTIVE -> DRAFT transition is allowed; drafting from any other state returns 400 invalid_state_transition. A benefit assigned to an active earning rule cannot be moved to draft (423 resource_locked, key connected_active_earning_rule).

post/v2/loyalties/benefits/{benefitId}/draft

Path parameters

idstring required

Unique benefit ID, prefixed with lben_.

Response

The drafted benefit

idstring required

Unique benefit ID, prefixed with lben_.

namestring required

Benefit name, unique within the project.

type'POINTS' | 'POINTS_PROPORTIONAL' | 'MATERIAL' | 'DIGITAL' required

Benefit type.

status'DRAFT' | 'ACTIVE' | 'DELETED' required

Current benefit status. DELETED appears only in the response of the delete endpoint and in activity snapshots.

created_atstring date-time required

Timestamp of when the benefit was created, in ISO 8601 format.

updated_atstring date-time

Timestamp of the last update, in ISO 8601 format. Null when the benefit was never updated.

objectstring required

Type of the object. Always benefit.