Skip to main content
PUT
/
v2
/
loyalties
/
programs
/
{programId}
/
rewards
/
{rewardId}
Update program reward assignment
curl --request PUT \
  --url {protocol}://{host}/v2/loyalties/programs/{programId}/rewards/{rewardId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-App-Id: <api-key>' \
  --header 'X-App-Token: <api-key>' \
  --data '
{
  "stock": {
    "limited": {
      "quantity": 4503599627370495
    }
  }
}
'
{
  "reward_id": "<string>",
  "stock": {
    "limited": {
      "quantity": 4503599627370495
    }
  },
  "redeemed": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "object": "<string>"
}
{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}
{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}
{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}
{
  "code": 123,
  "key": "<string>",
  "message": "<string>",
  "details": "<string>",
  "request_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

​
X-App-Id
string
header
required
​
X-App-Token
string
header
required

Path Parameters

​
programId
string
required

Unique program identifier.

Pattern: ^lprg_[a-f0-9]+$
​
rewardId
string
required

Unique reward identifier.

Pattern: ^lrew_[a-f0-9]+$

Body

application/json

Payload for updating the stock configuration of a reward assigned to a program.

​
stock
object
required

Reward stock configuration. When type is UNLIMITED, limited must not be provided. When type is LIMITED, limited is required.

Response

The updated reward assignment.

A reward assigned to a program, with stock configuration and redemption counter.

​
reward_id
string

Unique reward identifier.

Pattern: ^lrew_[a-f0-9]+$
​
stock
object

Stock configuration of the assignment.

​
redeemed
number

Number of times the reward has been redeemed within the program. Defaults to 0.

​
created_at
string<date-time>

Assignment creation timestamp (ISO 8601).

​
updated_at
string<date-time> | null

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

​
object
string

Object type marker.

Allowed value: "program_reward"
Last modified on July 9, 2026