CEcensys
Exposure Management

Remove an exclusion from an attack surface

Changed on

Remove an exclusion, so that the asset is no longer kept out of an attack surface. Removing an asset that is not present is not an error.<br><br>This endpoint does not cost credits to execute.

delete/v1/attacksurfaces/{attack_surface_id}/excludes/{asset}

Request

  • Base URL
    https://api.platform.censys.io
  • URL
    https://api.platform.censys.io/v1/attacksurfaces/{attack_surface_id}/excludes/{asset}
  • Auth
    HTTP bearer

Path parameters

attack_surface_idstring required

The ID of the attack surface, or the literal 'default' for your organization's attack surface. Obtain the attack surface ID using the list attack surfaces endpoint.

Example:11111111-2222-3333-4444-555555555555
assetstring required

The asset to remove, as an IP address, CIDR block, ASN, domain, or certificate SHA-256 fingerprint, the same way it was added and listed (for example 8.8.8.8, 8.8.8.0/24, AS15169 or censys.io). A '/' in the value must be URL-encoded as '%2F'.

Example:8.8.8.8

Query parameters

organization_idstring uuid required

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information.

Example:11111111-2222-3333-4444-555555555555

Headers

X-Organization-IDstring uuid

The ID of a Censys organization to associate the request with. See the Getting Started docs for more information. Note: The header parameter is supported for atypical use cases; we recommend always providing this field via the query parameter.

Example:11111111-2222-3333-4444-555555555555

Response

Asset removed successfully

Changes