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.
The Azure organization ID
The Bitbucket workspace ID
The Github owner ID
Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.
The GitLab group ID
The Nullify installation ID
Filter by Azure repository IDs
Filter by GitHub repository IDs
Filter by GitHub team ID
Filter by Bitbucket repository IDs
OK
GET /dast/exploit-validation/policies HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
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.
The Azure organization ID
The Bitbucket workspace ID
The Github owner ID
Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.
The GitLab group ID
The Nullify installation ID
Filter by Azure repository IDs
Filter by GitHub repository IDs
Filter by GitHub team ID
Filter by Bitbucket repository IDs
OK
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"
]
}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.
The Azure organization ID
The Bitbucket workspace ID
The Github owner ID
Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.
The GitLab group ID
The Nullify installation ID
Filter by Azure repository IDs
Filter by GitHub repository IDs
Filter by GitHub team ID
Filter by Bitbucket repository IDs
OK
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"
]
}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.
The Azure organization ID
The Bitbucket workspace ID
The Github owner ID
Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.
The GitLab group ID
The Nullify installation ID
Filter by Azure repository IDs
Filter by GitHub repository IDs
Filter by GitHub team ID
Filter by Bitbucket repository IDs
OK
DELETE /dast/exploit-validation/policies/{policyId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
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.
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.
The Azure organization ID
The Bitbucket workspace ID
The Github owner ID
Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.
The GitLab group ID
The Nullify installation ID
Filter by Azure repository IDs
Filter by GitHub repository IDs
Filter by GitHub team ID
Filter by Bitbucket repository IDs
OK
Bad Request
Forbidden
Not Found
Precondition Failed
Internal Server Error
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.
Revoke a policy's authority to dispatch exploit-validation runs, and the consent record granted with it.
The Azure organization ID
The Bitbucket workspace ID
The Github owner ID
Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.
The GitLab group ID
The Nullify installation ID
Filter by Azure repository IDs
Filter by GitHub repository IDs
Filter by GitHub team ID
Filter by Bitbucket repository IDs
OK
Forbidden
Not Found
Internal Server Error
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.
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.
The Azure organization ID
The Bitbucket workspace ID
The Github owner ID
Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.
The GitLab group ID
The Nullify installation ID
Filter by Azure repository IDs
Filter by GitHub repository IDs
Filter by GitHub team ID
Filter by Bitbucket repository IDs
OK
Bad Request
Not Found
Precondition Failed
Internal Server Error
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.
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.
The Azure organization ID
The Bitbucket workspace ID
The Github owner ID
Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.
The GitLab group ID
The Nullify installation ID
Filter by Azure repository IDs
Filter by GitHub repository IDs
Filter by GitHub team ID
Filter by Bitbucket repository IDs
OK
Bad Request
Not Found
Internal Server Error
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.
Returns a tenant-scoped, newest-first, paginated list of finding exploit-validation attempts and their outcomes. Paginate with the opaque nextToken.
The Azure organization ID
The Bitbucket workspace ID
The Github owner ID
Operator routes only: the GitHub App installation ID to use alongside githubOwnerId when the tenant's stored record has none. Ignored on customer routes.
The GitLab group ID
The Nullify installation ID
Filter by Azure repository IDs
Filter by GitHub repository IDs
Filter by GitHub team ID
Filter by Bitbucket repository IDs
OK
Bad Request
Internal Server Error
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