CEcensys
Exposure Management

Add assets to an attack surface

Changed on

Add assets as seeds, the starting points from which Censys discovers the rest of your attack surface. Name each asset as an IP address, CIDR block, ASN (for example AS15169), domain, or certificate SHA-256 fingerprint. <br><br>You may submit up to 50 assets per request. Inputting an asset that you have previously added will not return an error.<br><br>This endpoint does not cost credits to execute.

post/v1/attacksurfaces/{attack_surface_id}/assets

Request

  • Base URL
    https://api.platform.censys.io
  • URL
    https://api.platform.censys.io/v1/attacksurfaces/{attack_surface_id}/assets
  • 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

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

Request body

assetsstring[] required

The assets, each an IP address, CIDR block, ASN, domain, or certificate SHA-256 fingerprint.

Example request

{
  "assets": [
    "8.8.8.8",
    "censys.io",
    "AS15169",
    "8.8.8.0/24",
    "9a1d0c3a7b6e4f5d8c2b1a0f9e8d7c6b5a4f3e2d1c0b9a8f7e6d5c4b3a291807"
  ]
}

Response

Assets applied successfully

Example response

{
  "result": {
    "assets": [
      {
        "asset": "8.8.8.0/24"
      }
    ]
  }
}

Changes