Create a new reward
POST/reward
Create a new reward
Request
- application/json
Body
Data for creating a new reward
Detailed description of the reward
Optional URL for the reward's thumbnail image.
Unique identifier for Reward
ID of the project associated with the reward
Expiration date for special rewards
Unique identifier for RewardType
Possible values: <= 1000000
Points required to claim the reward
Name of the reward
Additional JSON metadata for triggers, actions or general easy-access data
Maximum number of times this reward can be redeemed.
Responses
- 201
- 400
- 401
- 403
- 404
- 500
- default
Reward successfully created
- application/json
- Schema
- Example (from schema)
Schema
Detailed description of the reward
Optional URL for the reward's thumbnail image.
Unique identifier for Reward
ID of the project associated with the reward
Expiration date for special rewards
Unique identifier for RewardType
Number of times this reward has been redeemed.
Number of times this reward has been redeemed by the current user.
Possible values: <= 1000000
Points required to claim the reward
Name of the reward
Time representation of entity creation
Additional JSON metadata for triggers, actions or general easy-access data
Maximum number of times this reward can be redeemed.
{
"description": "By completing the quest you're awarded with a shimmery golden badge",
"thumbnail": "https://file.playmakers.co/r15Y7T4sM/r15Y7T4sM_thumbnail.png",
"id": "r3b19Z1n",
"projectId": "pGdouyKfY",
"expiresAt": "2025-01-01T09:00:00.00Z",
"rewardTypeId": "R3b19Z1n",
"userRewardCount": 1,
"myUserRewardCount": 2,
"requiredPoints": 10,
"name": "Achievement Unlocked: Explorer",
"createdAt": "2024-01-01T09:00:00.00Z",
"data": "{\"criteria\": \"complete_all_adventure_quests\", \"icon\": \"explorer_badge_icon.png\"}",
"maxClaims": null
}
Bad Request
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"error": "string"
}
{
"error": "Bad Request"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"error": "string"
}
{
"error": "Unauthorized access"
}
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"
}
Unexpected error
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"error": "string"
}
{
"error": "An unexpected error occured"
}