Policy User Scope Update API

Update a policy user scope

post

Update a policy user scope, define inclusion/exclusion rule for users using user emails. Only supports Google Drive policies, separates internal or external users based on google domains registered in Nightfall. You can use this endpoint with Nightfall Sensitive Data Protction, Exfiltration Prevention, and Data Security Posture Management.

Authorizations

Path parameters

policyIDstring · uuidRequired

The UUID of the policy to update

Body

Responses

200

Successful response (processed immediately)

application/json

400

Invalid request parameters

application/json

401

Authentication failure

application/json

403

Operation prohibited on the policy

application/json

404

Policy not found

application/json

429

Rate Limit Exceeded or Daily Quota Exceeded

application/json

500

Internal Nightfall Error

application/json

post

HTTPcURLJavaScriptPython

POST /policy/v1/{policyID}/scope/users HTTP/1.1
Host: api.nightfall.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 136

{
  "add": {
    "include": [
      "[e-mail]"
    ],
    "exclude": [
      "[e-mail]"
    ]
  },
  "delete": {
    "include": [
      "[e-mail]"
    ],
    "exclude": [
      "[e-mail]"
    ]
  }
}

{
  "includedUsers": [
    "text"
  ],
  "excludedUsers": [
    "text"
  ]
}