post https://{host}/api_gateway/v1/badges/customer/revokeEarn
This API allows you to revoke an issued badge (earned badge by the customer).
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 authentication
- Default access group
Resource information
| URI | /api_gateway/v1/badges/customer/revokeEarn |
| HTTP method | POST |
| Rate limit | NA |
| Batch support | NA |
API endpoint example
https://eucrm.cc.capillarytech.com/api_gateway/v1/badges/badgeMeta/customer/revokeEarn
Request body parameters
| Parameter | Data Type | Description |
|---|---|---|
| badgeMetaId* | String | Unique identifier ("id") generated during the creation of the badge |
| customerId* | String | Unique identifier of the customer. |
| earnedBadgeId* | String | Earned Badge ID generated during the badge issue. |
{
"badgeMetaId": "653ddb33b3cda7078c7c68e9",
"customerId": 62090013,
"earnedBadgeId": "654cbea06bccde1274b6d3a2"
}
Response parameters
| Parameter | Data Type | Description |
|---|---|---|
| badgeMetaId | String | Unique identifier for the badge metadata. |
| customerId | Number | Unique identifier for the customer. |
| earnedBadgeId | String | Unique identifier for the earned badge. |
| isActive | Boolean | Indicates whether the badge is active (true) or inactive (false). |
{
"data": {
"badgeMetaId": "653ddb33b3cda7078c7c68e9",
"customerId": 62090013,
"earnedBadgeId": "654cbea06bccde1274b6d3a2",
"isActive": false
},
"errors": [],
"warnings": []
}
API-specific error codes
| Error code | Description |
|---|---|
| 814 | Active earn instance is not present. |