Delete unconsumed pool values
curl --request DELETE \
--url https://api.rigaly.com/api/v1/rewards/{id}/pool/codes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"values": [
"NFLX-A1B2C3"
]
}
'const options = {
method: 'DELETE',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({values: ['NFLX-A1B2C3']})
};
fetch('https://api.rigaly.com/api/v1/rewards/{id}/pool/codes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.rigaly.com/api/v1/rewards/{id}/pool/codes"
payload = { "values": ["NFLX-A1B2C3"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.rigaly.com/api/v1/rewards/{id}/pool/codes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_POSTFIELDS => json_encode([
'values' => [
'NFLX-A1B2C3'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"success": true,
"message": "Pool codes deleted successfully",
"data": {
"reward_id": "3f2b1c9e-7d4a-4f1b-8c2e-9a0d1e2f3b4c",
"deleted": 12,
"total": 137,
"available": 0,
"consumed": 137,
"capacity": 100000
}
}{
"success": false,
"error": {
"message": "REWARD_NOT_POOL_SOURCED"
}
}{
"success": false,
"error": {
"message": "Reward not found"
}
}Rewards
Delete unconsumed pool values
Removes values that have not been handed to a customer — the ones you
name in values, or every unconsumed value when you omit the body.
Consumed values are never deleted. They are what a customer already
received, so they stay on the pool as an audit trail (and keep counting
towards total); a value you asked to delete that had already been
consumed simply won’t appear in deleted.
DELETE
/
api
/
v1
/
rewards
/
{id}
/
pool
/
codes
Delete unconsumed pool values
curl --request DELETE \
--url https://api.rigaly.com/api/v1/rewards/{id}/pool/codes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"values": [
"NFLX-A1B2C3"
]
}
'const options = {
method: 'DELETE',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({values: ['NFLX-A1B2C3']})
};
fetch('https://api.rigaly.com/api/v1/rewards/{id}/pool/codes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.rigaly.com/api/v1/rewards/{id}/pool/codes"
payload = { "values": ["NFLX-A1B2C3"] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.delete(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.rigaly.com/api/v1/rewards/{id}/pool/codes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_POSTFIELDS => json_encode([
'values' => [
'NFLX-A1B2C3'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"success": true,
"message": "Pool codes deleted successfully",
"data": {
"reward_id": "3f2b1c9e-7d4a-4f1b-8c2e-9a0d1e2f3b4c",
"deleted": 12,
"total": 137,
"available": 0,
"consumed": 137,
"capacity": 100000
}
}{
"success": false,
"error": {
"message": "REWARD_NOT_POOL_SOURCED"
}
}{
"success": false,
"error": {
"message": "Reward not found"
}
}Authorizations
API key from the Rigaly dashboard: Authorization: Bearer rgly_sk_...
Path Parameters
Body
application/json
Which unconsumed values to remove. Omit the body entirely (or values) to delete every unconsumed value.
The exact values to delete. Consumed values are silently skipped — they are what a customer already received.
Required array length:
1 - 5000 elementsRequired string length:
1 - 500Example:
["NFLX-A1B2C3"]