Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Policy Update APIs

Update a policy user scope

post

Update a policy user scope, define inclusion/exclusion rule for users using user emails. Only supports gDrive policies, separates internal or external users based on google domains registered in Nightfall.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
policyIDstring · uuidRequired

The UUID of the policy to update

Body
Responses
200

Successful response (processed immediately)

application/json
post/{policyID}/scope/users
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": [
      "name@gmail.com"
    ],
    "exclude": [
      "name@gmail.com"
    ]
  },
  "delete": {
    "include": [
      "name@gmail.com"
    ],
    "exclude": [
      "name@gmail.com"
    ]
  }
}
{
  "includedUsers": [
    "text"
  ],
  "excludedUsers": [
    "text"
  ]
}

Update a policy domain scope

post

Update a policy domain scope, define inclusion/exclusion rule for domains. Only supports gDrive policies.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
policyIDstring · uuidRequired

The UUID of the policy to update

Body
Responses
200

Successful response (processed immediately)

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

{
  "add": {
    "include": [
      "text"
    ],
    "exclude": [
      "text"
    ]
  },
  "delete": {
    "include": [
      "text"
    ],
    "exclude": [
      "text"
    ]
  }
}
{
  "includedDomains": [
    "text"
  ],
  "excludedDomains": [
    "text"
  ]
}

Update a posture policy trigger user scope

post

Update trigger-scoped users for a posture management policy. Modifies users stored in the trigger scope. Only supports posture management policies of gDrive.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
policyIDstring · uuidRequired

The UUID of the policy to update

Body
Responses
200

Successful response (processed immediately)

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

{
  "add": {
    "include": [
      "name@gmail.com"
    ],
    "exclude": [
      "name@gmail.com"
    ]
  },
  "delete": {
    "include": [
      "name@gmail.com"
    ],
    "exclude": [
      "name@gmail.com"
    ]
  }
}
{
  "includedUsers": [
    "text"
  ],
  "excludedUsers": [
    "text"
  ]
}

Update a posture policy trigger domain scope

post

Update trigger-scoped domains for a posture management policy. Modifies domains stored in trigger scope. Only supports posture management policies of gDrive.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Path parameters
policyIDstring · uuidRequired

The UUID of the policy to update

Body
Responses
200

Successful response (processed immediately)

application/json
post/{policyID}/trigger/domains
POST /policy/v1/{policyID}/trigger/domains HTTP/1.1
Host: api.nightfall.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 96

{
  "add": {
    "include": [
      "text"
    ],
    "exclude": [
      "text"
    ]
  },
  "delete": {
    "include": [
      "text"
    ],
    "exclude": [
      "text"
    ]
  }
}
{
  "includedDomains": [
    "text"
  ],
  "excludedDomains": [
    "text"
  ]
}
PreviousRate Limits for Native SaaS app APIs
NextExfiltration Prevention APIs

Last updated

Was this helpful?