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

Exploit Validation

Exploit validation tries to prove, against a deployed non-production copy of your application, that a SAST or SCA finding is exploitable. It never runs on its own authority: a tenant policy describes what may be validated, a person arms the policy, and the target must be confirmed non-production. See Targets and web services for target classification and write-risk consent.

All routes are under https://api.<TENANT>.nullify.ai.

Policies

A policy selects findings (by findingTypes of SAST or SCA, minimumSeverity and minimumExploitability), the web services to validate against, a weekly window (daysOfWeek 0 to 6, startTime and endTime as HH:mm, and an IANA timezone) and a revalidationCooldownDays between 7 and 365. Writing a policy never grants permission to attack: policy writes can clear arming but only the arm route can set it.

List policies

Returns every exploit validation policy for the tenant, including each one's armed state.

List Exploit Validation Policies

get
Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
get/dast/exploit-validation/policies
GET /dast/exploit-validation/policies HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
200

OK

{
  "policies": [
    {
      "armed": true,
      "armedAt": "2026-01-01T00:00:00.000Z",
      "armedBy": "text",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "daysOfWeek": [
        1
      ],
      "enabled": true,
      "endTime": "text",
      "findingTypes": [
        "sast"
      ],
      "grantedCapabilities": [
        "text"
      ],
      "id": "text",
      "minimumExploitability": "text",
      "minimumSeverity": "text",
      "name": "text",
      "revalidationCooldownDays": 1,
      "safetyContractVersion": 1,
      "startTime": "text",
      "timezone": "text",
      "updatedAt": "2026-01-01T00:00:00.000Z",
      "webServiceIds": [
        "text"
      ]
    }
  ]
}

Create, update and delete a policy

Creates a policy. All fields are required and are validated: a name, at least one valid finding type, at least one existing web service, at least one day, HH:mm times, a valid timezone, severity and exploitability thresholds, and a cooldown of 7 to 365 days. Invalid input returns 400. A new policy is not armed.

Create Exploit Validation Policy

post
Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
daysOfWeekinteger[] · nullableRequired
enabledbooleanRequired
endTimestringRequired
minimumExploitabilitystringRequired
minimumSeveritystringRequired
namestringRequired
revalidationCooldownDaysinteger · min: 7 · max: 365Required
startTimestringRequired
timezonestringRequired
webServiceIdsstring[] · nullableRequired
Responses
200

OK

application/json
post/dast/exploit-validation/policies
POST /dast/exploit-validation/policies HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 235

{
  "daysOfWeek": [
    1
  ],
  "enabled": true,
  "endTime": "text",
  "findingTypes": [
    "sast"
  ],
  "minimumExploitability": "text",
  "minimumSeverity": "text",
  "name": "text",
  "revalidationCooldownDays": 1,
  "startTime": "text",
  "timezone": "text",
  "webServiceIds": [
    "text"
  ]
}
200

OK

{
  "policy": {
    "armed": true,
    "armedAt": "2026-01-01T00:00:00.000Z",
    "armedBy": "text",
    "createdAt": "2026-01-01T00:00:00.000Z",
    "daysOfWeek": [
      1
    ],
    "enabled": true,
    "endTime": "text",
    "findingTypes": [
      "sast"
    ],
    "grantedCapabilities": [
      "text"
    ],
    "id": "text",
    "minimumExploitability": "text",
    "minimumSeverity": "text",
    "name": "text",
    "revalidationCooldownDays": 1,
    "safetyContractVersion": 1,
    "startTime": "text",
    "timezone": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "webServiceIds": [
      "text"
    ]
  }
}

Replaces a policy with the same validation as create. Web services the policy already references remain valid even if they have since been deleted, so toggling enabled does not fail on them; newly added web services must exist. Returns 404 for an unknown policy.

Update Exploit Validation Policy

put
Path parameters
policyIdstringRequired
Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
daysOfWeekinteger[] · nullableRequired
enabledbooleanRequired
endTimestringRequired
minimumExploitabilitystringRequired
minimumSeveritystringRequired
namestringRequired
revalidationCooldownDaysinteger · min: 7 · max: 365Required
startTimestringRequired
timezonestringRequired
webServiceIdsstring[] · nullableRequired
Responses
200

OK

application/json
put/dast/exploit-validation/policies/{policyId}
PUT /dast/exploit-validation/policies/{policyId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 235

{
  "daysOfWeek": [
    1
  ],
  "enabled": true,
  "endTime": "text",
  "findingTypes": [
    "sast"
  ],
  "minimumExploitability": "text",
  "minimumSeverity": "text",
  "name": "text",
  "revalidationCooldownDays": 1,
  "startTime": "text",
  "timezone": "text",
  "webServiceIds": [
    "text"
  ]
}
200

OK

{
  "policy": {
    "armed": true,
    "armedAt": "2026-01-01T00:00:00.000Z",
    "armedBy": "text",
    "createdAt": "2026-01-01T00:00:00.000Z",
    "daysOfWeek": [
      1
    ],
    "enabled": true,
    "endTime": "text",
    "findingTypes": [
      "sast"
    ],
    "grantedCapabilities": [
      "text"
    ],
    "id": "text",
    "minimumExploitability": "text",
    "minimumSeverity": "text",
    "name": "text",
    "revalidationCooldownDays": 1,
    "safetyContractVersion": 1,
    "startTime": "text",
    "timezone": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "webServiceIds": [
      "text"
    ]
  }
}

Deletes a policy. Returns 404 for an unknown policy.

Delete Exploit Validation Policy

delete
Path parameters
policyIdstringRequired
Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
deletedbooleanRequired
delete/dast/exploit-validation/policies/{policyId}
DELETE /dast/exploit-validation/policies/{policyId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
200

OK

{
  "deleted": true
}

Arm and disarm a policy

Grants the policy authority to dispatch runs, and records who consented. It needs the exploit-validation arming permission, enforced regardless of tenant RBAC rollout, and a person caller: internal services and service-account tokens get 403. Send safetyContractVersion (1 for the default anonymous_read capability, 2 when capabilities includes authenticated_session, which is admitted only on deployments where authenticated exploit validation is enabled) and expectedUpdatedAt, the updatedAt you read from the policy, so an edit made after the consent is refused. A disabled or changed policy returns 412, and a wrong contract version or unsupported capability returns 400.

Arm an Exploit Validation Policy

post

Grant a policy authority to dispatch exploit-validation runs at its targets. Requires the safety contract version this build enforces and the policy revision the consent was given against. Separate from policy write, which can revoke arming but never grant it.

Path parameters
policyIdstringRequired
Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Body
expectedUpdatedAtstring · date-timeRequired
safetyContractVersionintegerRequired
Responses
200

OK

application/json
post/dast/exploit-validation/policies/{policyId}/arm
POST /dast/exploit-validation/policies/{policyId}/arm HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "capabilities": [
    "anonymous_read"
  ],
  "expectedUpdatedAt": "2026-01-01T00:00:00.000Z",
  "safetyContractVersion": 1
}
{
  "policy": {
    "armed": true,
    "armedAt": "2026-01-01T00:00:00.000Z",
    "armedBy": "text",
    "createdAt": "2026-01-01T00:00:00.000Z",
    "daysOfWeek": [
      1
    ],
    "enabled": true,
    "endTime": "text",
    "findingTypes": [
      "sast"
    ],
    "grantedCapabilities": [
      "text"
    ],
    "id": "text",
    "minimumExploitability": "text",
    "minimumSeverity": "text",
    "name": "text",
    "revalidationCooldownDays": 1,
    "safetyContractVersion": 1,
    "startTime": "text",
    "timezone": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "webServiceIds": [
      "text"
    ]
  }
}

Revokes the policy's authority and clears the consent record granted with it. It needs the same permission and a person caller as arming. Returns 404 for an unknown policy.

Disarm an Exploit Validation Policy

post

Revoke a policy's authority to dispatch exploit-validation runs, and the consent record granted with it.

Path parameters
policyIdstringRequired
Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
post/dast/exploit-validation/policies/{policyId}/disarm
POST /dast/exploit-validation/policies/{policyId}/disarm HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "policy": {
    "armed": true,
    "armedAt": "2026-01-01T00:00:00.000Z",
    "armedBy": "text",
    "createdAt": "2026-01-01T00:00:00.000Z",
    "daysOfWeek": [
      1
    ],
    "enabled": true,
    "endTime": "text",
    "findingTypes": [
      "sast"
    ],
    "grantedCapabilities": [
      "text"
    ],
    "id": "text",
    "minimumExploitability": "text",
    "minimumSeverity": "text",
    "name": "text",
    "revalidationCooldownDays": 1,
    "safetyContractVersion": 1,
    "startTime": "text",
    "timezone": "text",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "webServiceIds": [
      "text"
    ]
  }
}

Running validation

Start validation for a finding

Asks Nullify to validate one SAST or SCA finding. The call is asynchronous: a response means the request was evaluated, not that validation finished. The response always carries a runId, and started is true with an executionArn only when a run was dispatched; otherwise reason says why it was declined, for example not_http_testable, no_policy_match, policy_unarmed, within_cooldown, production_target_refused, unclassified_target_refused, ambiguous_target_refused or no_web_service. A finding that is deleted, superseded, fixed, archived, allowlisted, a false positive or a duplicate returns 412, and so does one missing severity or exploitability metadata; other finding types return 400. Requires the finding-write permission, and 404 is returned for an unknown finding. Poll the result with Get an exploit validation run.

Start Exploit Validation for a Finding

post

Decline SAST findings that cannot be proven over HTTP before evaluating tenant policies. Start asynchronous finding-scoped exploit-validation runs against matching web services when eligible.

Path parameters
findingIdstringRequired
Query parameters
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
executionArnstringOptional
executionArnsstring[]Optional
reasonstringOptional
runIdstringOptional
startedbooleanOptional
versionstringOptional
post/dast/exploit-validation/findings/{findingId}/validate
POST /dast/exploit-validation/findings/{findingId}/validate HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "executionArn": "text",
  "executionArns": [
    "text"
  ],
  "reason": "text",
  "runId": "text",
  "started": true,
  "version": "text"
}

Get an exploit validation run

Returns the progress of the run a start request returned as runId: each finding's decision (declined findings are reported as skipped with the reason), and for a dispatched finding its verdict and proof once recorded, otherwise it stays running. Pass the start response's executionArn as the executionArn query parameter to let the read notice an execution that ended without recording a verdict. A malformed runId returns 400 and an unknown one 404.

Get Exploit Validation Run

get

Returns the status of the exploit-validation run a start request returned as runId: each finding's decision, and for a dispatched finding its verdict and proof once the run records one.

Path parameters
runIdstringRequired
Query parameters
executionArnstringOptional
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
completedAtstringOptional
errorstringOptional
runIdstringRequired
startedAtstringOptional
statestring · enumRequiredPossible values:
terminalbooleanOptional
get/dast/exploit-validation/runs/{runId}
GET /dast/exploit-validation/runs/{runId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "attempts": [
    {
      "completedAt": "text",
      "confidence": 1,
      "decidedAt": "text",
      "decision": "dispatched",
      "error": "text",
      "exploitedCve": "text",
      "findingId": "text",
      "findingType": "text",
      "outcome": "text",
      "reason": "text",
      "report": "text",
      "reproductionScript": "text",
      "state": "PENDING",
      "targetUrl": "text",
      "webServiceId": "text"
    }
  ],
  "completedAt": "text",
  "error": "text",
  "runId": "text",
  "startedAt": "text",
  "state": "PENDING",
  "terminal": true
}

List exploit validation attempts

Lists the tenant's finding validation attempts, newest first, paginated with nextToken and limit (default page size 20). There is one attempt per finding, updated in place by each run. Only completed and declined attempts carry an outcome, confidence, cost and duration; for a declined attempt these are the previous completed run's values. A bad nextToken returns 400.

List Exploit Validation Attempts

get

Returns a tenant-scoped, newest-first, paginated list of finding exploit-validation attempts and their outcomes. Paginate with the opaque nextToken.

Query parameters
nextTokenstringOptional
limitintegerOptional
azureOrganizationIdstringOptional

The Azure organization ID

bitbucketWorkspaceIdstringOptional

The Bitbucket workspace ID

githubOwnerIdinteger · int64Optional

The Github owner ID

githubInstallationIdinteger · int64Optional

Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.

gitlabGroupIdinteger · int64Optional

The GitLab group ID

installationIdstringOptional

The Nullify installation ID

azureRepositoryIdstring[]Optional

Filter by Azure repository IDs

githubRepositoryIdinteger · int64[]Optional

Filter by GitHub repository IDs

githubTeamIdinteger · int64Optional

Filter by GitHub team ID

bitbucketRepositoryIdstring[]Optional

Filter by Bitbucket repository IDs

Responses
200

OK

application/json
nextTokenstringRequired
numItemsintegerRequired
get/dast/exploit-validation/attempts
GET /dast/exploit-validation/attempts HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
  "attempts": [
    {
      "attemptedCves": [
        "text"
      ],
      "completedAt": "text",
      "confidence": 1,
      "costUsd": 1,
      "createdAt": "text",
      "durationSeconds": 1,
      "exploitedCve": "text",
      "findingId": "text",
      "findingTitle": "text",
      "findingType": "text",
      "hasEndpointProof": true,
      "id": "text",
      "outcome": "text",
      "startedAt": "text",
      "status": "text",
      "statusReason": "text",
      "updatedAt": "text"
    }
  ],
  "nextToken": "text",
  "numItems": 1
}

Last updated