Redeem reward
redeem_rewardExchange loyalty points for a reward. This spends points: confirm the reward and its cost with the user and set confirm to true only after explicit agreement. Physical rewards need a shipping address.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"slug": "<slug>",
"idempotencyKey": "<idempotencyKey>",
"confirm": "<confirm>"
},
"name": "redeem_reward"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City for shipping a physical reward. | |
| slug | Yes | Reward identifier (slug) from list_rewards. | |
| phone | No | Phone number without the country prefix. | |
| street | No | Street and number for shipping a physical reward. | |
| confirm | Yes | Must be true. Set it only after the user explicitly confirmed this action. | |
| fullName | No | Recipient name for shipping a physical reward. | |
| postalCode | No | Postal code for shipping a physical reward. | |
| countryCode | No | Shipping country as a two-letter ISO code. | |
| idempotencyKey | Yes | Unique key of 8 to 100 characters that you generate once per attempt. Repeating it never creates a duplicate. |