Sign in

69be73b5cff0

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

Update earning rule

<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 an earning rule. All properties are optional; status cannot be changed through this endpoint (use the activate/deactivate/draft endpoints). For rules that are not in DRAFT status, only the following properties may effectively change: name, earnings, error, validity_hours, start_date, end_date, trigger_limits, metadata. Earnings items may carry an id (lernei_...) to update an existing earning item; items without an id are created.

put/v2/loyalties/earning-rules/{earningRuleId}

Path parameters

idstring required

Earning rule ID.

Request body

namestring

Earning rule name.

start_datestring date-time nullable

Date-time from which the rule is active. Can be null.

end_datestring date-time nullable

Date-time until which the rule is active. Can be null.

metadataMetadata

Arbitrary key-value metadata; any JSON object is accepted.

Response

Updated earning rule

idstring

Earning rule ID (lern_...).

namestring

Earning rule name.

status'DRAFT' | 'ACTIVE' | 'INACTIVE'

Current status. DELETED also exists internally but deleted rules are excluded from API reads.

start_datestring date-time nullable

Date-time from which the rule is active. Can be null.

end_datestring date-time nullable

Date-time until which the rule is active. Can be null.

metadataMetadata

Arbitrary key-value metadata; any JSON object is accepted.

created_atstring date-time

Creation timestamp (ISO 8601).

updated_atstring date-time nullable

Last update timestamp (ISO 8601). null when never updated.

object'earning_rule'

Object type marker. Always earning_rule.