CEcensys
Exposure Management

Create an attack surface

Changed on

Create the attack surface for your organization. An organization can have only one attack surface. Censys begins discovering its assets as you add seeds to it.<br><br>This endpoint does not cost credits to execute.

post/v1/attacksurfaces

Request

  • Base URL
    https://api.platform.censys.io
  • URL
    https://api.platform.censys.io/v1/attacksurfaces
  • Auth
    HTTP bearer

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

Attack surface created successfully

Example response

{
  "result": {
    "id": "11111111-2222-3333-4444-555555555555"
  }
}

Changes