update
PATCH
/api/v1/accounts/:account_id/rewards/:id
Update a reward
Updates an existing reward. The card_id cannot be changed after creation.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id
|
Must be a number. | Required |
Store (account) ID |
id
|
Must be a number. | Required |
Reward ID |
reward
|
Must be a Hash | Required |
Reward attributes to update |
reward[name]
|
Must be a String | Optional |
Display name of the reward |
reward[description]
|
Must be a String | Optional |
Detailed description of the reward |
reward[stamps_required]
|
Must be a number. | Optional |
Number of stamps needed to unlock this reward (must be > 0) |
reward[position]
|
Must be a number. | Optional |
Display order position |
reward[active]
|
Must be one of: true, false, 1, 0.
|
Optional |
Whether the reward is active and redeemable |
Error Codes
| Code | Description |
|---|---|
401
|
Unauthorized – invalid or missing API token |
404
|
Store or reward not found |
422
|
Validation failed – check `errors` for details |