v

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

Rewards

Move reward back to draft

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

Moves the reward back to the DRAFT status. Allowed only from ACTIVE status; other transitions are rejected with a conflict error. The reward can't be assigned to a loyalty program. This endpoint takes no request body.

post/v2/loyalties/rewards/{rewardId}/draft

Path parameters

idstring required

Unique reward identifier, prefixed with lrew_.

Response

The drafted reward.

idstring required

Unique reward identifier, prefixed with lrew_.

namestring required

Display name of the reward.

type'MATERIAL' | 'DIGITAL' required

Reward type.

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

Current lifecycle status of the reward.

start_datestring date-time nullable

Date from which the reward is available, or null when not set.

end_datestring date-time nullable

Date until which the reward is available, or null when not set.

metadataobject required

Arbitrary key-value metadata attached to the reward. Empty object when not set.

created_atstring date-time required

Timestamp when the reward was created (ISO-8601).

updated_atstring date-time nullable

Timestamp when the reward was last updated (ISO-8601), or null when never updated.

object'reward' required

Object type marker; always reward.

Example response

{
  "validity_hours": {
    "daily": [
      {
        "start_time": "09:00",
        "end_time": "17:00"
      }
    ]
  }
}