Update a reward by ID
PUT/reward/:rewardId
Update a reward by ID
Request
Path Parameters
The unique identifier for the reward to update
- application/json
Body
Data for updating the reward
Expiration date for special rewards
Thumbnail image for the reward
Maximum amount of times the reward can be claimed globally
Possible values: <= 1000000
Points required to claim the reward
Detailed description of the reward
Possible values: <= 32 characters
Name of the reward
Additional JSON metadata for triggers, actions, or general easy-access data
Responses
- 200
- 403
- 404
- 500
Reward updated successfully
- application/json
- Schema
- Example (from schema)
Schema
Expiration date for special rewards
Unique identifier for RewardType
ID of the project associated with the reward
Number of times this reward has been redeemed.
Possible values: <= 1000000
Points required to claim the reward
The order in which the reward should be displayed
Additional JSON metadata for triggers, actions or general easy-access data
Number of times this reward has been redeemed by the current user.
Maximum allowed number of times for the reward to be redeemed by a single user
Optional URL for the reward's thumbnail image.
Time representation of entity creation
Maximum number of times this reward can be redeemed.
Unique identifier for Reward
Possible values: <= 32 characters
Name of the reward
Detailed description of the reward
{
"expiresAt": "2025-01-01T09:00:00.00Z",
"rewardTypeId": "R3b19Z1n",
"projectId": "pGdouyKfY",
"userRewardCount": 1,
"requiredPoints": 10,
"rankOrder": 1,
"data": "{\"criteria\": \"complete_all_adventure_quests\", \"icon\": \"explorer_badge_icon.png\"}",
"myUserRewardCount": 2,
"userRewardsLimit": 3,
"thumbnail": "https://file.playmakers.co/r15Y7T4sM/r15Y7T4sM_thumbnail.png",
"createdAt": "2024-01-01T09:00:00.00Z",
"maxClaims": null,
"id": "r3b19Z1n",
"name": "Amazon gift card",
"description": "By completing the quest you're awarded with a shimmery golden badge"
}
Forbidden
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"error": "string"
}
{
"error": "Forbidden access"
}
NotFound
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"error": "string"
}
{
"error": "A mandatory item was not found"
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"error": "string"
}
{
"error": "Internal Server Error"
}