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

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/applications is 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/applications is 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 Applications

get

List DAST applications for the tenant

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
get/dast/applications
GET /dast/applications HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
200

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 Application

post

Create a DAST application — a set of web services, each deployed to one or more targets

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
contextApplicationIdstringOptional
descriptionstringOptional
namestringOptional
scopeExcludePatternsstring[]Optional

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.

webServiceIdsstring[] · nullableRequired
Responses
200

OK

application/json
post/dast/applications
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"
  ]
}
200

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 Application

get

Get a DAST application by ID

Path parameters
applicationIdstringRequired
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/applications/{applicationId}
GET /dast/applications/{applicationId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
200

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 Application

put

Update a DAST application

Path parameters
applicationIdstringRequired
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
descriptionstringOptional
namestringOptional
scopeExcludePatternsstring[] · nullableOptional

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.

webServiceIdsstring[] · nullableRequired
Responses
200

OK

application/json
put/dast/applications/{applicationId}
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"
  ]
}
200

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.

Delete Application

delete

Soft-delete a DAST application

Path parameters
applicationIdstringRequired
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
successbooleanRequired
delete/dast/applications/{applicationId}
DELETE /dast/applications/{applicationId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
200

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 Pentest App Configs

get

Get all pentest application configs for a tenant

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
get/dast/pentest/applications
GET /dast/pentest/applications HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
200

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 Application

post

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.

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
credentialIdsstring[] · nullableRequired
idstringOptional
Responses
200

OK

application/json
post/dast/pentest/applications
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 Pentest App Config

get

Get a specific pentest application config by ID

Path parameters
applicationIdstringRequired
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/pentest/applications/{applicationId}
GET /dast/pentest/applications/{applicationId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
200

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 Application

put

Update an existing application. Omitted or null targets preserve existing target links; an empty targets array detaches all targets.

Path parameters
applicationIdstringRequired
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
credentialIdsstring[]Optional
Responses
200

OK

application/json
put/dast/pentest/applications/{applicationId}
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
    }
  ]
}
200

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 Application

patch

Partially update an existing application. Omitted or null targets preserve existing target links; an empty targets array detaches all targets.

Path parameters
applicationIdstringRequired
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
credentialIdsstring[]Optional
Responses
200

OK

application/json
patch/dast/pentest/applications/{applicationId}
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
    }
  ]
}
200

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 Pentest App Config

delete

Delete a pentest application config

Path parameters
applicationIdstringRequired
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
successbooleanRequired
delete/dast/pentest/applications/{applicationId}
DELETE /dast/pentest/applications/{applicationId} HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
200

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.

Get Pentest Cost Estimate

get

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.

Path parameters
applicationIdstringRequired
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/pentest/applications/{applicationId}/estimate
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.

Start Pentest Preflight

post

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.

Path parameters
applicationIdstringRequired
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
triggeredByScanbooleanOptional
Responses
200

OK

application/json
post/dast/pentest/applications/{applicationId}/preflight
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.

Get Latest Pentest Preflight for Application

get

Returns the most recent pentest preflight for an application, or null if the customer has never run one.

Path parameters
applicationIdstringRequired
Query parameters
webServiceIdstringOptional
targetIdstringOptional
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
stalebooleanOptional
get/dast/pentest/applications/{applicationId}/preflight/latest
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.

Get Pentest Preflight Quota

get

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.

Path parameters
applicationIdstringRequired
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
limitinteger · int64Required
usedinteger · int64Required
windowResetAtstring · date-timeRequired
get/dast/pentest/applications/{applicationId}/preflight/quota
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.

Get Pentest Preflight

get

Returns a single pentest preflight by ID, including the readiness summary when complete.

Path parameters
preflightIdstringRequired
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/pentest/preflights/{preflightId}
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.

Get Pentest Preflight Events

get

Returns the live event stream for a preflight execution. Use the afterSeq query parameter (echoing the previous response's highestSeq) for incremental polling.

Path parameters
preflightIdstringRequired
Query parameters
afterSeqinteger · int64Optional
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
highestSeqinteger · int64Required
versionstringOptional
get/dast/pentest/preflights/{preflightId}/events
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.

Get Pentest Budget

get

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.

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
consumedUsdnumber · doubleRequired
frozenbooleanRequired
heldUsdnumber · doubleRequired
limitUsdnumber · doubleRequired
remainingUsdnumber · doubleRequired
timeWindowstringOptional
unlimitedbooleanRequired
windowEndstringOptional
get/dast/pentest/budget
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 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.

Create Interactor []

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
textstringRequired
versionstringRequired
get/dast/pentest/mutation-warning
GET /dast/pentest/mutation-warning HTTP/1.1
Host: api.<TENANT>.nullify.ai
Accept: */*
200

OK

{
  "text": "text",
  "version": "text"
}

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.

put
Path parameters
applicationIdstringRequired
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
enabledbooleanRequired
warningVersionstringOptional
Responses
204

No Content

No content

put/dast/pentest/applications/{applicationId}/mutation-consent
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"
}
204

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.

Get Source IPs

get

Returns the public IP addresses from which DAST scans originate: the pentest rig elastic IPs and the NAT gateway addresses hosted scans egress through

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
ipsstring[] · nullableRequired
regionstringRequired
get/dast/sourceips
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