Pentest Applications, Preflight and Budget
Applications, their targets and web services, the preflight readiness check, cost estimates, budget headroom, mutation-testing consent, and the source IP addresses to allowlist. Start a run with POST /dast/pentest/start once an application is configured.
All requests are scoped to your tenant by the same provider scope parameter (for example githubOwnerId) used across the API, and every id is resolved within that tenant. Page through lists with nextToken as described in pagination.
Two views of an application
Two route families manage the same applications, one application id and one stored record, through different shapes.
/dast/applicationsis the full model. An application is a named set of web services (created under/dast/web-services, which carry the targets and credential mappings) plus an optional deny list of paths that must not be tested. It requires at least one existing web service./dast/pentest/applicationsis the flattened pentest configuration for the same application id: a list of targets (host and port) and a list of credential ids, plus the mutation-testing consent state. An application created or deleted through one family appears in or disappears from the other.
Use /dast/applications to describe what an application is made of, and /dast/pentest/applications when all you need is targets and credentials for a run. An id you supply on a pentest configuration target that matches a target of your tenant at the same host and port means that target. Any other target is matched by host and port, reusing a stored target at that endpoint, so an id that names nothing is not preserved and reads report the stored or generated id. An entry with no matching id is refused with 409 when two linked targets share its host and port. The /dast/pentest/applications create call takes the application id from you, and it must be the id of an existing application in your context application inventory: an unknown id is refused with 404 and nothing is stored. The /dast/applications create call can also resolve the id from that inventory, as described below.
Applications
List applications
Returns the tenant's applications from /dast/applications, paginated with nextToken and limit. Use the returned ids as applicationId in the other routes.
List DAST applications for the tenant
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/applications HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
OK
{
"applications": [
{
"allowMutationTesting": true,
"createdAt": "2026-01-01T00:00:00.000Z",
"description": "text",
"id": "text",
"mutationAckAt": "2026-01-01T00:00:00.000Z",
"mutationAckBy": "text",
"mutationWarningVersion": "text",
"name": "text",
"scopeExcludePatterns": [
"text"
],
"updatedAt": "2026-01-01T00:00:00.000Z",
"webServices": [
{
"apiType": "REST",
"createdAt": "2026-01-01T00:00:00.000Z",
"description": "text",
"id": "text",
"name": "text",
"projectId": "text",
"repoPath": "text",
"repositoryId": "text",
"targets": [
{
"path": "text",
"targetId": "text"
}
],
"updatedAt": "2026-01-01T00:00:00.000Z"
}
]
}
],
"nextToken": "text"
}Create an application
Creates an application from webServiceIds (at least one, deduplicated, each of which must already exist in your tenant, otherwise the call returns 404). The application's id is its context application id: pass contextApplicationId to choose one (404 if it does not exist), or omit it and Nullify resolves it from the repositories your web services are mapped to. The call fails with 400 if no web service is mapped to a repository or if they span more than one context application, and with 412 if no context application covers them, so connect the repository to an application in context first. A duplicate id returns 409. scopeExcludePatterns are case-insensitive [METHOD ]<path> deny rules that include subtrees; a rule that cannot be compiled is rejected with 400. Requires the config-write permission.
Create a DAST application — a set of web services, each deployed to one or more targets
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
Case-insensitive [METHOD ] deny rules including subtrees. Target paths are relative to the target base path; admitted target subdomains match both mounted and root paths, and other admitted hosts match root paths. Omit METHOD to deny all methods. Ambiguous encoded paths are refused.
OK
POST /dast/applications HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 123
{
"contextApplicationId": "text",
"description": "text",
"name": "text",
"scopeExcludePatterns": [
"text"
],
"webServiceIds": [
"text"
]
}OK
{
"application": {
"allowMutationTesting": true,
"createdAt": "2026-01-01T00:00:00.000Z",
"description": "text",
"id": "text",
"mutationAckAt": "2026-01-01T00:00:00.000Z",
"mutationAckBy": "text",
"mutationWarningVersion": "text",
"name": "text",
"scopeExcludePatterns": [
"text"
],
"updatedAt": "2026-01-01T00:00:00.000Z",
"webServices": [
{
"apiType": "REST",
"createdAt": "2026-01-01T00:00:00.000Z",
"description": "text",
"id": "text",
"name": "text",
"projectId": "text",
"repoPath": "text",
"repositoryId": "text",
"targets": [
{
"path": "text",
"targetId": "text"
}
],
"updatedAt": "2026-01-01T00:00:00.000Z"
}
]
}
}Get an application
Returns one application by applicationId. Returns 404 if it does not exist in your tenant.
Get a DAST application by ID
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/applications/{applicationId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
OK
{
"application": {
"allowMutationTesting": true,
"createdAt": "2026-01-01T00:00:00.000Z",
"description": "text",
"id": "text",
"mutationAckAt": "2026-01-01T00:00:00.000Z",
"mutationAckBy": "text",
"mutationWarningVersion": "text",
"name": "text",
"scopeExcludePatterns": [
"text"
],
"updatedAt": "2026-01-01T00:00:00.000Z",
"webServices": [
{
"apiType": "REST",
"createdAt": "2026-01-01T00:00:00.000Z",
"description": "text",
"id": "text",
"name": "text",
"projectId": "text",
"repoPath": "text",
"repositoryId": "text",
"targets": [
{
"path": "text",
"targetId": "text"
}
],
"updatedAt": "2026-01-01T00:00:00.000Z"
}
]
}
}Update an application
Replaces the application's web services, name, description and scopeExcludePatterns with the request body. It is a full replacement, not a merge, so send the complete list of webServiceIds (at least one) and the same validation as create applies. Returns 404 for an unknown id. Requires the config-write permission.
Update a DAST application
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
Case-insensitive [METHOD ] deny rules including subtrees. Target paths are relative to the target base path; admitted target subdomains match both mounted and root paths, and other admitted hosts match root paths. Omit METHOD to deny all methods. Ambiguous encoded paths are refused. Omitted or null preserves stored rules; an empty array clears them.
OK
PUT /dast/applications/{applicationId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 93
{
"description": "text",
"name": "text",
"scopeExcludePatterns": [
"text"
],
"webServiceIds": [
"text"
]
}OK
{
"application": {
"allowMutationTesting": true,
"createdAt": "2026-01-01T00:00:00.000Z",
"description": "text",
"id": "text",
"mutationAckAt": "2026-01-01T00:00:00.000Z",
"mutationAckBy": "text",
"mutationWarningVersion": "text",
"name": "text",
"scopeExcludePatterns": [
"text"
],
"updatedAt": "2026-01-01T00:00:00.000Z",
"webServices": [
{
"apiType": "REST",
"createdAt": "2026-01-01T00:00:00.000Z",
"description": "text",
"id": "text",
"name": "text",
"projectId": "text",
"repoPath": "text",
"repositoryId": "text",
"targets": [
{
"path": "text",
"targetId": "text"
}
],
"updatedAt": "2026-01-01T00:00:00.000Z"
}
]
}
}Delete an application
Soft-deletes the application and records the caller as the deleter. Returns 404 if it does not exist. Requires the config-write permission.
Soft-delete a DAST application
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/applications/{applicationId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
OK
{
"success": true
}Pentest application configuration
List pentest application configs
Lists every application's pentest configuration (targets, credential ids, creation and update times), paginated with nextToken and limit. Requires the config-read permission.
Get all pentest application configs for a tenant
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/pentest/applications HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
OK
{
"applications": [
{
"allowMutationTesting": true,
"createdAt": "2026-01-01T00:00:00.000Z",
"credentialIds": [
"text"
],
"defaultScanConfig": {
"apiType": "REST",
"attackMode": "text",
"attackStrength": "text",
"disabledChecks": [
"text"
],
"enabledChecks": [
"text"
],
"excludePatterns": [
"text"
],
"includePatterns": [
"text"
],
"isExternal": true,
"maxDepth": 1,
"maxDurationMinutes": 1,
"rateLimit": {
"burstSize": 1,
"requestsPerSecond": 1
},
"requestTimeoutSeconds": 1,
"scannerType": "text",
"scannerVersion": "text",
"targetUrl": "text",
"threadCount": 1,
"userAgents": [
"text"
]
},
"id": "text",
"mutationAckAt": "2026-01-01T00:00:00.000Z",
"mutationAckBy": "text",
"mutationWarningVersion": "text",
"targets": [
{
"host": "text",
"id": "text",
"isProd": true,
"name": "text",
"nonProductionConfirmedAt": "2026-01-01T00:00:00.000Z",
"port": 1
}
],
"updatedAt": "2026-01-01T00:00:00.000Z"
}
],
"nextToken": "text"
}Create a pentest application
Creates a pentest configuration under the id you supply (required). targets are objects with name, host and port; a target without an id gets a generated one (see the note above on target ids). Hosts and ports are validated, and the number of targets and credentials is capped. credentialIds must refer to existing credentials, otherwise the call returns 400. A live duplicate id returns 409; re-creating a previously deleted id is accepted and applies the new configuration. Requires the config-write permission.
Create the pentest configuration of an existing application. The id must be the id of a live context application; an unknown id is refused with 404.
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
Conflict
Service Unavailable
Gateway Timeout
POST /dast/pentest/applications HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 169
{
"credentialIds": [
"text"
],
"id": "text",
"targets": [
{
"host": "text",
"id": "text",
"isProd": true,
"name": "text",
"nonProductionConfirmedAt": "2026-01-01T00:00:00.000Z",
"port": 1
}
]
}{
"application": {
"allowMutationTesting": true,
"createdAt": "2026-01-01T00:00:00.000Z",
"credentialIds": [
"text"
],
"defaultScanConfig": {
"apiType": "REST",
"attackMode": "text",
"attackStrength": "text",
"disabledChecks": [
"text"
],
"enabledChecks": [
"text"
],
"excludePatterns": [
"text"
],
"includePatterns": [
"text"
],
"isExternal": true,
"maxDepth": 1,
"maxDurationMinutes": 1,
"rateLimit": {
"burstSize": 1,
"requestsPerSecond": 1
},
"requestTimeoutSeconds": 1,
"scannerType": "text",
"scannerVersion": "text",
"targetUrl": "text",
"threadCount": 1,
"userAgents": [
"text"
]
},
"id": "text",
"mutationAckAt": "2026-01-01T00:00:00.000Z",
"mutationAckBy": "text",
"mutationWarningVersion": "text",
"targets": [
{
"host": "text",
"id": "text",
"isProd": true,
"name": "text",
"nonProductionConfirmedAt": "2026-01-01T00:00:00.000Z",
"port": 1
}
],
"updatedAt": "2026-01-01T00:00:00.000Z"
}
}Get a pentest application
Returns one pentest configuration by applicationId, or 404. Requires the config-read permission.
Get a specific pentest application config by ID
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/pentest/applications/{applicationId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
OK
{
"application": {
"allowMutationTesting": true,
"createdAt": "2026-01-01T00:00:00.000Z",
"credentialIds": [
"text"
],
"defaultScanConfig": {
"apiType": "REST",
"attackMode": "text",
"attackStrength": "text",
"disabledChecks": [
"text"
],
"enabledChecks": [
"text"
],
"excludePatterns": [
"text"
],
"includePatterns": [
"text"
],
"isExternal": true,
"maxDepth": 1,
"maxDurationMinutes": 1,
"rateLimit": {
"burstSize": 1,
"requestsPerSecond": 1
},
"requestTimeoutSeconds": 1,
"scannerType": "text",
"scannerVersion": "text",
"targetUrl": "text",
"threadCount": 1,
"userAgents": [
"text"
]
},
"id": "text",
"mutationAckAt": "2026-01-01T00:00:00.000Z",
"mutationAckBy": "text",
"mutationWarningVersion": "text",
"targets": [
{
"host": "text",
"id": "text",
"isProd": true,
"name": "text",
"nonProductionConfirmedAt": "2026-01-01T00:00:00.000Z",
"port": 1
}
],
"updatedAt": "2026-01-01T00:00:00.000Z"
}
}Update a pentest application
Replaces the configuration. If targets is present it replaces the whole target list (and is validated as in create); if it is omitted the targets are left unchanged. If credentialIds is present it replaces the credential list, and an empty array clears it; if it is omitted the credentials are left unchanged. An empty targets array removes the targets and keeps the application's web service, its credentials and its source mapping, and a run then reports that the web service has no targets. Returns 404 for an unknown id and 400 for an unknown credential. Returns 409 and writes nothing when the application changed since it was read, or when the change needs a web service edit: a target change on an application with a mounted, shared or more than one web service, or a new credential on a shared or more than one web service.
Update an existing application. Omitted or null targets preserve existing target links; an empty targets array detaches all targets.
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/pentest/applications/{applicationId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 157
{
"credentialIds": [
"text"
],
"targets": [
{
"host": "text",
"id": "text",
"isProd": true,
"name": "text",
"nonProductionConfirmedAt": "2026-01-01T00:00:00.000Z",
"port": 1
}
]
}OK
{
"application": {
"allowMutationTesting": true,
"createdAt": "2026-01-01T00:00:00.000Z",
"credentialIds": [
"text"
],
"defaultScanConfig": {
"apiType": "REST",
"attackMode": "text",
"attackStrength": "text",
"disabledChecks": [
"text"
],
"enabledChecks": [
"text"
],
"excludePatterns": [
"text"
],
"includePatterns": [
"text"
],
"isExternal": true,
"maxDepth": 1,
"maxDurationMinutes": 1,
"rateLimit": {
"burstSize": 1,
"requestsPerSecond": 1
},
"requestTimeoutSeconds": 1,
"scannerType": "text",
"scannerVersion": "text",
"targetUrl": "text",
"threadCount": 1,
"userAgents": [
"text"
]
},
"id": "text",
"mutationAckAt": "2026-01-01T00:00:00.000Z",
"mutationAckBy": "text",
"mutationWarningVersion": "text",
"targets": [
{
"host": "text",
"id": "text",
"isProd": true,
"name": "text",
"nonProductionConfirmedAt": "2026-01-01T00:00:00.000Z",
"port": 1
}
],
"updatedAt": "2026-01-01T00:00:00.000Z"
}
}Partially update a pentest application
Changes only the fields you send: a present targets replaces the target list, and an empty array removes the targets under the same rules as PUT. A present credentialIds replaces the credential list (send an empty array to clear it). Target hosts must be bare hostnames or IPs without a scheme or path. This route applies the target-count and port validation, and a target already stored for your tenant keeps its stored host and port without re-validation. It does not generate ids for targets sent without one, so include each target's id to keep that target. The response carries the current mutationConsent state.
Partially update an existing application. Omitted or null targets preserve existing target links; an empty targets array detaches all targets.
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
PATCH /dast/pentest/applications/{applicationId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 157
{
"credentialIds": [
"text"
],
"targets": [
{
"host": "text",
"id": "text",
"isProd": true,
"name": "text",
"nonProductionConfirmedAt": "2026-01-01T00:00:00.000Z",
"port": 1
}
]
}OK
{
"application": {
"allowMutationTesting": true,
"createdAt": "2026-01-01T00:00:00.000Z",
"credentialIds": [
"text"
],
"defaultScanConfig": {
"apiType": "REST",
"attackMode": "text",
"attackStrength": "text",
"disabledChecks": [
"text"
],
"enabledChecks": [
"text"
],
"excludePatterns": [
"text"
],
"includePatterns": [
"text"
],
"isExternal": true,
"maxDepth": 1,
"maxDurationMinutes": 1,
"rateLimit": {
"burstSize": 1,
"requestsPerSecond": 1
},
"requestTimeoutSeconds": 1,
"scannerType": "text",
"scannerVersion": "text",
"targetUrl": "text",
"threadCount": 1,
"userAgents": [
"text"
]
},
"id": "text",
"mutationAckAt": "2026-01-01T00:00:00.000Z",
"mutationAckBy": "text",
"mutationWarningVersion": "text",
"targets": [
{
"host": "text",
"id": "text",
"isProd": true,
"name": "text",
"nonProductionConfirmedAt": "2026-01-01T00:00:00.000Z",
"port": 1
}
],
"updatedAt": "2026-01-01T00:00:00.000Z"
}
}Move a target or credential to another application
POST /dast/pentest/applications/{applicationId}/move moves one item from this application to toApplicationId, in one transaction. Send targetId or credentialId, not both. The rules of the update apply to both applications, and a refusal from either returns 409 and writes nothing to both. A destination with no pentest configuration is created in the same transaction when it is a live context application. Returns 400 when the destination already holds the maximum number of targets or credentials, 404 for an unknown application, and 409 when this application no longer holds the item. A target change revokes the exploit-validation consent of policies linking the web services it changes. Requires the config-write permission.
Delete a pentest application
Deletes the pentest configuration and records the caller as the deleter. Returns 404 if it does not exist. Requires the config-write permission.
Delete a pentest application config
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/pentest/applications/{applicationId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
OK
{
"success": true
}Estimate, preflight and budget
Estimate pentest cost
Predicts the duration and LLM cost of a pentest for the application without running anything and without calling an LLM. The result is a heuristic. When the application has a stored preflight with a resolved application context, the estimate is sized from it and source is preflight; otherwise source is heuristic and the figures are coarser. In both cases the estimate is blended with the median duration of the application's own completed pentests when there are any (basedOnHistoricalRuns is the count of runs used). Compare the cost with Get pentest budget.
Predicts the duration and LLM cost of a pentest for an application using a closed-form heuristic over the application's size signals and its own run history. Runs no agent and issues no LLM calls. Sharpens the estimate with the application's stored preflight when one exists, and reports which of the two sources it used.
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
Internal Server Error
GET /dast/pentest/applications/{applicationId}/estimate HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
"estimate": {
"basedOnHistoricalRuns": 1,
"confidence": "low",
"durationSeconds": 1,
"inputTokens": 1,
"llmCostUsdCents": 1,
"outputTokens": 1,
"source": "preflight"
}
}Start a preflight
Starts a readiness check for the application ahead of a pentest. It validates credentials, retrieves application context, enumerates network-reachable findings, and produces a summary and an estimate. The response is the new preflight with a runStatus of in progress: the check is asynchronous, so poll Get a preflight or Get preflight events. Errors: 404 if the application is unknown, 400 if it has no target, 409 if a preflight is already running for that application, and 429 once five non-failed preflights have been started for the application in the last 24 hours. Requires the finding-write permission.
Runs a readiness check for an application before a pentest scan. Validates credentials, retrieves application context, enumerates network-reachable findings, and produces a typed three-level summary plus a duration / cost estimate for the upcoming pentest.
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
Conflict
Too Many Requests
Internal Server Error
POST /dast/pentest/applications/{applicationId}/preflight HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 79
{
"deployment": {
"targetId": "text",
"webServiceId": "text"
},
"triggeredByScan": true
}{
"preflight": {
"applicationId": "text",
"configFingerprint": "text",
"deployment": {
"targetId": "text",
"webServiceId": "text"
},
"endTime": "2026-01-01T00:00:00.000Z",
"executionArn": "text",
"failureReason": "text",
"id": "text",
"lastScanId": "text",
"runStatus": "queued",
"startTime": "2026-01-01T00:00:00.000Z",
"summary": {
"appContextSnapshot": {
"apiEndpointCount": 1,
"apiEndpointsSample": [
"text"
],
"apiSchemaArtifactId": "text",
"apiSchemaBasis": "text",
"apiSchemaDigest": "text",
"apiSchemaOrigin": "text",
"apiSchemaPartial": true,
"apiSchemaSourceCommit": "text",
"apiSchemaSourceRef": "text",
"apiSchemaType": "text",
"componentCount": 1,
"components": [
{
"commitHash": "text",
"componentId": "text",
"name": "text",
"repositoryId": "text"
}
],
"contextStatus": "text",
"coverage": 1,
"lastContextSyncTime": "2026-01-01T00:00:00.000Z",
"resolved": true
},
"checks": [
{
"category": "credentials",
"deepLinkRef": "text",
"fixHint": "text",
"message": "text",
"name": "text",
"status": "cannot_run"
}
],
"generatedAt": "2026-01-01T00:00:00.000Z",
"pentestEstimate": {
"basedOnHistoricalRuns": 1,
"confidence": "low",
"durationSeconds": 1,
"llmCostUsdCents": 1,
"tokens": {
"input": 1,
"output": 1
}
},
"reachableFindings": [
{
"findingId": "text",
"isInternetFacing": true,
"kind": "sast",
"reachabilityPath": [
"text"
],
"severity": "CRITICAL",
"title": "text"
}
],
"status": "cannot_run",
"summary": "text",
"validatedCredentials": [
{
"credentialId": "text",
"evidence": {
"duration": 1,
"error": "text",
"message": "text",
"reasonCode": "text",
"responseHeaders": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"status": "unknown",
"statusCode": 1,
"testUrl": "text",
"validatedBy": "text"
},
"status": "unknown"
}
]
},
"tenantId": "text",
"triggeredByScan": true
}
}Get the latest preflight for an application
Returns the application's most recent preflight, or null if none has ever been run.
Returns the most recent pentest preflight for an application, or null if the customer has never run 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/pentest/applications/{applicationId}/preflight/latest HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
"preflight": {
"applicationId": "text",
"configFingerprint": "text",
"deployment": {
"targetId": "text",
"webServiceId": "text"
},
"endTime": "2026-01-01T00:00:00.000Z",
"executionArn": "text",
"failureReason": "text",
"id": "text",
"lastScanId": "text",
"runStatus": "queued",
"startTime": "2026-01-01T00:00:00.000Z",
"summary": {
"appContextSnapshot": {
"apiEndpointCount": 1,
"apiEndpointsSample": [
"text"
],
"apiSchemaArtifactId": "text",
"apiSchemaBasis": "text",
"apiSchemaDigest": "text",
"apiSchemaOrigin": "text",
"apiSchemaPartial": true,
"apiSchemaSourceCommit": "text",
"apiSchemaSourceRef": "text",
"apiSchemaType": "text",
"componentCount": 1,
"components": [
{
"commitHash": "text",
"componentId": "text",
"name": "text",
"repositoryId": "text"
}
],
"contextStatus": "text",
"coverage": 1,
"lastContextSyncTime": "2026-01-01T00:00:00.000Z",
"resolved": true
},
"checks": [
{
"category": "credentials",
"deepLinkRef": "text",
"fixHint": "text",
"message": "text",
"name": "text",
"status": "cannot_run"
}
],
"generatedAt": "2026-01-01T00:00:00.000Z",
"pentestEstimate": {
"basedOnHistoricalRuns": 1,
"confidence": "low",
"durationSeconds": 1,
"llmCostUsdCents": 1,
"tokens": {
"input": 1,
"output": 1
}
},
"reachableFindings": [
{
"findingId": "text",
"isInternetFacing": true,
"kind": "sast",
"reachabilityPath": [
"text"
],
"severity": "CRITICAL",
"title": "text"
}
],
"status": "cannot_run",
"summary": "text",
"validatedCredentials": [
{
"credentialId": "text",
"evidence": {
"duration": 1,
"error": "text",
"message": "text",
"reasonCode": "text",
"responseHeaders": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"status": "unknown",
"statusCode": 1,
"testUrl": "text",
"validatedBy": "text"
},
"status": "unknown"
}
]
},
"tenantId": "text",
"triggeredByScan": true
},
"stale": true
}Get preflight quota
Returns used, limit (5) and windowResetAt for the application's rolling 24-hour preflight window, from the same count the start route enforces.
Returns the daily preflight usage and limit for an application. Used by the UI to render an indicator and disable buttons when the limit is reached.
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
Internal Server Error
GET /dast/pentest/applications/{applicationId}/preflight/quota HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
"limit": 1,
"used": 1,
"windowResetAt": "2026-01-01T00:00:00.000Z"
}Get a preflight
Returns one preflight by preflightId (from the start response or the latest route), including the readiness summary once the run completes. Poll until runStatus is terminal. Returns 404 for an unknown id.
Returns a single pentest preflight by ID, including the readiness summary when complete.
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
Not Found
Internal Server Error
GET /dast/pentest/preflights/{preflightId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
"preflight": {
"applicationId": "text",
"configFingerprint": "text",
"deployment": {
"targetId": "text",
"webServiceId": "text"
},
"endTime": "2026-01-01T00:00:00.000Z",
"executionArn": "text",
"failureReason": "text",
"id": "text",
"lastScanId": "text",
"runStatus": "queued",
"startTime": "2026-01-01T00:00:00.000Z",
"summary": {
"appContextSnapshot": {
"apiEndpointCount": 1,
"apiEndpointsSample": [
"text"
],
"apiSchemaArtifactId": "text",
"apiSchemaBasis": "text",
"apiSchemaDigest": "text",
"apiSchemaOrigin": "text",
"apiSchemaPartial": true,
"apiSchemaSourceCommit": "text",
"apiSchemaSourceRef": "text",
"apiSchemaType": "text",
"componentCount": 1,
"components": [
{
"commitHash": "text",
"componentId": "text",
"name": "text",
"repositoryId": "text"
}
],
"contextStatus": "text",
"coverage": 1,
"lastContextSyncTime": "2026-01-01T00:00:00.000Z",
"resolved": true
},
"checks": [
{
"category": "credentials",
"deepLinkRef": "text",
"fixHint": "text",
"message": "text",
"name": "text",
"status": "cannot_run"
}
],
"generatedAt": "2026-01-01T00:00:00.000Z",
"pentestEstimate": {
"basedOnHistoricalRuns": 1,
"confidence": "low",
"durationSeconds": 1,
"llmCostUsdCents": 1,
"tokens": {
"input": 1,
"output": 1
}
},
"reachableFindings": [
{
"findingId": "text",
"isInternetFacing": true,
"kind": "sast",
"reachabilityPath": [
"text"
],
"severity": "CRITICAL",
"title": "text"
}
],
"status": "cannot_run",
"summary": "text",
"validatedCredentials": [
{
"credentialId": "text",
"evidence": {
"duration": 1,
"error": "text",
"message": "text",
"reasonCode": "text",
"responseHeaders": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"status": "unknown",
"statusCode": 1,
"testUrl": "text",
"validatedBy": "text"
},
"status": "unknown"
}
]
},
"tenantId": "text",
"triggeredByScan": true
}
}Get preflight events
Returns the progress events of a preflight run for incremental polling. Pass afterSeq=0 on the first call, then pass the highestSeq from the previous response; limit bounds the page.
Returns the live event stream for a preflight execution. Use the afterSeq query parameter (echoing the previous response's highestSeq) for incremental polling.
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/pentest/preflights/{preflightId}/events HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
"events": [
{
"data": null,
"id": "text",
"time": "text",
"type": "repo_context_agent_started"
}
],
"highestSeq": 1,
"version": "text"
}Get pentest budget
Returns the tenant's remaining pentest budget for the tightest applicable calendar window: limitUsd, consumedUsd, heldUsd, remainingUsd, timeWindow and windowEnd. unlimited means no budget caps pentests (ignore the dollar figures), and frozen means a configured limit of zero, which denies all runs. It reads billing on your behalf and can return a transient error if billing is unavailable. Requires the finding-read permission.
Returns the tenant's remaining pentest budget for the tightest applicable calendar window so an estimate can be compared with current headroom. Proxies the internal billing admission budget; the browser cannot reach that endpoint directly.
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
Internal Server Error
Service Unavailable
Gateway Timeout
GET /dast/pentest/budget HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
"consumedUsd": 1,
"frozen": true,
"heldUsd": 1,
"limitUsd": 1,
"remainingUsd": 1,
"timeWindow": "text",
"unlimited": true,
"windowEnd": "text"
}Mutation testing consent
Mutation testing sends state-changing requests to your application as each configured identity, to test who may create, modify and delete data. It is off until someone with write access acknowledges the current warning.
Get the mutation warning
Returns the text of the warning and its version. Show the text to the person enabling the feature, then send the version back when enabling.
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/pentest/mutation-warning HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
OK
{
"text": "text",
"version": "text"
}Set mutation consent
Enables or disables mutation testing for the application. Body: enabled (required) and warningVersion. When enabling, warningVersion must equal the current version from the warning route, otherwise the call fails with 400, so the acknowledgment always matches the text shown. The acknowledging user is recorded from the authenticated caller, and the caller needs the config-write permission (403 otherwise). Returns 404 for an unknown application. Disabling stops new mutation requests but does not undo changes already made.
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
No Content
No content
PUT /dast/pentest/applications/{applicationId}/mutation-consent HTTP/1.1
Host: api.<TENANT>.nullify.ai
Content-Type: application/json
Accept: */*
Content-Length: 40
{
"enabled": true,
"warningVersion": "text"
}No Content
No content
Source IP addresses
Get source IPs
Returns the public IP addresses that pentest traffic originates from, in ips (sorted, deduplicated) with the region. The list combines the addresses used for operator-driven runs and the addresses that hosted runs leave through, so allowlist all of them on your WAF or firewall. If the hosted-run addresses cannot be looked up, the response falls back to the operator-driven addresses only. Results are cached for 24 hours. Requires the config-read permission.
Returns the public IP addresses from which DAST scans originate: the pentest rig elastic IPs and the NAT gateway addresses hosted scans egress through
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
Internal Server Error
Service Unavailable
GET /dast/sourceips HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
{
"ips": [
"text"
],
"region": "text"
}```bash curl -s \ -H "Accept: application/json" \ -H "Authorization: Bearer " \ 'https://api..nullify.ai/dast/sourceips?githubOwnerId=1234' ```
Last updated