Delete a leaderboard
DELETE
/leaderboards/{leaderboardID}
Authorization headerleaderboard permissioncommunityID401 if the key is missing, invalid, or lacks the required permissiondelete:leaderboard pub/sub event; the gamification service processes it and performs the DB delete502 if the upstream gamification service is unreachable or the publisher times outleaderboardID must be a valid Mongo ObjectId or string ID404 if the leaderboard does not exist in this communityRequest
Path Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE 'https://api.returning.ai/v1/leaderboards/507f1f77bcf86cd799439012' \
--header 'Authorization: Bearer XXXXXX'Response Response Example
200 - Success Example
{
"meta": {
"status": "success",
"statusCode": 200
},
"message": "Delete leaderboard success.",
"data": "507f1f77bcf86cd799439012"
}Modified at 2026-04-20 06:48:15