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
}

Documentation Index

Fetch the complete documentation index at: https://wiki.netgraph-connect.com/llms.txt

Use this file to discover all available pages before exploring further.

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
}