Skip to main content
curl -X POST "$API_BASE_URL/v1/org/$ORG_ID/contexts/sign-in/$CTX_ID/modules/whitelistings/batch/remove" \
  -H "x-auth-token: $NETGRAPH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "macs": [
      { "mac": "AA:BB:CC:00:00:01" },
      { "mac": "AA:BB:CC:00:00:02" }
    ]
  }'
{
  "nrOfWhitelistingsInRevokeRequest": 2,
  "nrOfWhitelistingsThatHadActiveLoginsThatWereRevoked": 1
}
Removes many whitelist entries by MAC. Active sessions from the revoked devices are terminated.

Request

organizationId
string
required
Organization ID.
contextId
string
required
Sign-In Context ID.
x-auth-token
string
required
Context API key.
macs
object[]
required
Array of MAC-carrying objects.
curl -X POST "$API_BASE_URL/v1/org/$ORG_ID/contexts/sign-in/$CTX_ID/modules/whitelistings/batch/remove" \
  -H "x-auth-token: $NETGRAPH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "macs": [
      { "mac": "AA:BB:CC:00:00:01" },
      { "mac": "AA:BB:CC:00:00:02" }
    ]
  }'

Response

nrOfWhitelistingsInRevokeRequest
integer
How many MACs were in the request.
nrOfWhitelistingsThatHadActiveLoginsThatWereRevoked
integer
How many of those MACs had active sessions that were terminated as part of this call.
{
  "nrOfWhitelistingsInRevokeRequest": 2,
  "nrOfWhitelistingsThatHadActiveLoginsThatWereRevoked": 1
}