Skip to main content
curl -X PUT "$API_BASE_URL/v1/org/$ORG_ID/contexts/sign-in/$CTX_ID/modules/whitelistings" \
  -H "x-auth-token: $NETGRAPH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "7f2a-...",
    "mac": "AA:BB:CC:DD:EE:FF",
    "name": "Reception printer",
    "description": "Lobby floor — moved to right side",
    "toDate": "2027-06-30",
    "tags": [{ "value": "printer" }, { "value": "lobby" }]
  }'

HTTP/1.1 200 OK
Updates an existing whitelist entry. Identify the entry by its id.

​
Request

​
organizationId
string
required
Organization ID.
​
contextId
string
required
Sign-In Context ID.
​
x-auth-token
string
required
Context API key.
​
id
string
required
UUID of the whitelist entry to update.
​
mac
string
required
Device MAC address, format AA:BB:CC:DD:EE:FF or AA-BB-CC-DD-EE-FF.
​
name
string
required
Device name, 2–100 characters.
​
description
string
Description, 0–200 characters.
​
toDate
string (date)
Expiry date, YYYY-MM-DD. Pass null to make the entry permanent.
​
tags
object[]
Tag array; replaces the current tag set.
curl -X PUT "$API_BASE_URL/v1/org/$ORG_ID/contexts/sign-in/$CTX_ID/modules/whitelistings" \
  -H "x-auth-token: $NETGRAPH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "7f2a-...",
    "mac": "AA:BB:CC:DD:EE:FF",
    "name": "Reception printer",
    "description": "Lobby floor — moved to right side",
    "toDate": "2027-06-30",
    "tags": [{ "value": "printer" }, { "value": "lobby" }]
  }'

​
Response

HTTP/1.1 200 OK