Validations
Beta

Start a target validation

Validates that a target (asset) is reachable and in scope without running a full scan. The asset type determines the validation workflow (DNS, IP, range, REST, GraphQL, webapp). Poll GET /validations/{id} until status is FINISHED, FAILED, or CANCELED.

post/validations

Request

  • Base URL
    https://public.escape.tech/v3
  • Auth
    API key in header X-ESCAPE-API-KEY

Request body

proxyIdstring uuid nullable

Force a specific Escape or private location for this validation

defaultProxyType'ESCAPE' | 'PRIVATE'

When proxyId is omitted, restrict to Escape-managed locations or private locations

Response

OK

idstring uuid required

Identifier for this validation; use it when polling for status

status'CANCELED' | 'FAILED' | 'FINISHED' | 'RUNNING' | 'STARTING' required

Initial lifecycle state (typically STARTING right after creation)

Changes

No recorded changes to this operation across all 1 revision of this API.