Delete Blocklist Entry
curl --request DELETE \
--url https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId} \
--header 'Authorization: <authorization>' \
--header 'z-client: <z-client>'import requests
url = "https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}"
headers = {
"z-client": "<z-client>",
"Authorization": "<authorization>"
}
response = requests.delete(url, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {'z-client': '<z-client>', Authorization: '<authorization>'}
};
fetch('https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"z-client: <z-client>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("z-client", "<z-client>")
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}")
.header("z-client", "<z-client>")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["z-client"] = '<z-client>'
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "API version blocklist deleted successfully."
}
Blocklist
Delete Blocklist Entry
Remove a blocklist entry to restore client-side reward sending for your Rewards App.
DELETE
/
api
/
v1
/
rewards
/
app
/
{rewardsAppId}
/
api-version-blocklist
/
{blocklistId}
Delete Blocklist Entry
curl --request DELETE \
--url https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId} \
--header 'Authorization: <authorization>' \
--header 'z-client: <z-client>'import requests
url = "https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}"
headers = {
"z-client": "<z-client>",
"Authorization": "<authorization>"
}
response = requests.delete(url, headers=headers)
print(response.text)const options = {
method: 'DELETE',
headers: {'z-client': '<z-client>', Authorization: '<authorization>'}
};
fetch('https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>",
"z-client: <z-client>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("z-client", "<z-client>")
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}")
.header("z-client", "<z-client>")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["z-client"] = '<z-client>'
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "API version blocklist deleted successfully."
}
This operation re-enables client SDK access for the specified API route that was previously blocked.
Deleting a blocklist entry immediately re-enables client-side reward sending for that API route. Make sure you understand the security implications.
Reversible Action. You can always add the blocklist entry back if you need to restrict client-side rewards again.
Configuration
Header Parameters
string
required
Client identifier (use
“developer-dashboard” )string
required
Bearer token for authenticationFormat:
Bearer {JWT_TOKEN}Path Parameters
string
required
Your Rewards App ID
string
required
The ID of the blocklist entry to delete
Get this ID from the “Get Blocklist Entries” endpoint
{
"success": true,
"message": "API version blocklist deleted successfully."
}
{
"success": false,
"message": "Invalid UUID"
}
{
"success": false,
"message": "Authentication required"
}
{
"success": false,
"message": "Developer does not own this app"
}
{
"success": false,
"message": "Blocklist entry not found"
}
{
"success": false,
"message": "Internal server error"
}
Response Fields
| Field | Type | Description |
|---|---|---|
success | boolean | Whether the deletion was successful |
message | string | Confirmation message |
Response Status Codes
| Code | Description |
|---|---|
200 | Blocklist entry deleted successfully |
400 | Bad request - invalid UUID |
401 | Unauthorized - authentication required |
403 | Forbidden - developer does not own this app |
404 | Blocklist entry not found |
500 | Internal server error |
Code Examples
const rewardsAppId = 'YOUR_REWARDS_APP_ID';
const blocklistId = 'YOUR_BLOCKLIST_ID';
const jwtToken = 'YOUR_JWT_TOKEN';
async function deleteBlocklistEntry(rewardsAppId, blocklistId) {
const response = await fetch(
`https://api.zbdpay.com/api/v1/rewards/app/${rewardsAppId}/api-version-blocklist/${blocklistId}`,
{
method: 'DELETE',
headers: {
'z-client': 'developer-dashboard',
'Authorization': `Bearer ${jwtToken}`
}
}
);
const data = await response.json();
if (data.success) {
console.log('✅ Blocklist entry deleted successfully!');
console.log('Client-side rewards are now enabled.');
return data;
} else {
throw new Error(`Failed: ${data.message}`);
}
}
// Delete entry
await deleteBlocklistEntry(
'b28e0306-2c06-4092-8d56-a1623d6b97fb',
'bb6178d1-4fb5-4b35-93d6-31fe052b73dd'
);
curl --location --request DELETE 'https://api.zbdpay.com/api/v1/rewards/app/{rewardsAppId}/api-version-blocklist/{blocklistId}' \
--header 'z-client: developer-dashboard' \
--header 'Authorization: Bearer {JWT_TOKEN}'
import requests
import os
jwt_token = os.getenv('JWT_TOKEN')
def delete_blocklist_entry(rewards_app_id, blocklist_id):
"""Delete a blocklist entry to re-enable client rewards"""
url = f"https://api.zbdpay.com/api/v1/rewards/app/{rewards_app_id}/api-version-blocklist/{blocklist_id}"
headers = {
"z-client": "developer-dashboard",
"Authorization": f"Bearer {jwt_token}"
}
response = requests.delete(url, headers=headers)
data = response.json()
if data["success"]:
print("✅ Blocklist entry deleted successfully!")
print("Client-side rewards are now enabled.")
return data
else:
raise Exception(f"Failed: {data['message']}")
# Delete entry
delete_blocklist_entry(
"b28e0306-2c06-4092-8d56-a1623d6b97fb",
"bb6178d1-4fb5-4b35-93d6-31fe052b73dd"
)
What Happens After Deletion?
Before Deletion Client SDK Blocked
Client cannot send rewards
After Deletion Client SDK Enabled
Client can send rewards again
Try It Out
Ready to delete a blocklist entry? Use our API playground on the right to test with your JWT token.What’s Next?
Now that you’ve managed your blocklist entries, you can move on to managing your API keys:- List API Keys. View and manage the API keys used for backend authentication.
- Restrict Client-Side Rewards. Create a blocklist entry to disable client-side rewards again.
Was this page helpful?
⌘I