This API allows you to unclaim a badge. Using an unclaim API you can soft delete the active claim from the claims list.

For example:

A badge named Furry Friend Badge is owned by Loyalty and Milestones. Loyalty has successfully claimed the badge under program ID: 123, associating the badge claim with Loyalty as owner and reference ID: ABC. Using the unclaim badge API, you can remove Loyalty’s claim over the badge.

👍

Note

For detailed information about our APIs and for hands-on testing, refer documentation in API overview and step-by-step guide on making your first API call in Make your first API call.

Prerequisites

• Authentication: Basic or OAuth authentication
• Default access group

Resource information

Example request

curl --location 'https://eu.api.capillarytech.com/api_gateway/v1/badges/badgeMeta/69381220cebb9648d8974518/unclaim' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'accept: application/json' \
--header 'Authorization: Basic bWFkaHVMjU2YQ==' \
--header 'Cookie: _cfuvid=GwR6P.Wo28InVQzxrZVpalpv9uu696nsUn.b7W_MO8Y-1772617632944-0.0.1.1-604800000' \
--data '{
    "ownerType": "Loyalty",
    "referenceId": "123"
}'

Request path parameters

Request body parameters

{
"ownerType":"Loyalty",
"referenceId":"string"
}

Example response

{
    "data": {
        "ownerType": "Loyalty",
        "referenceId": "123",
        "isActive": false
    },
    "errors": null,
    "warnings": []
}

Response parameters

API-specific error codes