Create Exception

POST

/v2/exceptions

Last modified:2025-04-24 10:59:46

This endpoint allows you to create an exception for a specific vulnerability based on its NVT ID.
Exceptions can be scoped to affect vulnerabilities in different ways,
depending on the attributes you provide:

Scope by Host and Port:

If you specify the hosts and/or port attributes, the exception will apply to all occurrences of the
specified vulnerability across the given host(s) and port(s).

This can affect multiple scans that include the same vulnerability on the specified host(s) and port(s).

Scope by Scan:

If you specify the scan attribute (scan ID), the exception will apply to all occurrences of the
specified vulnerability within that specific scan only.

Request

Body Params application/json

Example

{
    "exception": {
        "text": "My Exception",
        "hosts": "178.151.13.5",
        "port": 8080,
        "task": "4879b8a6-fb3e-4a0d-aef8-b0ea469ac85c",
        "scan": "a7a2f3fe-ff95-4c3f-9ff0-56fb58648122",
        "new_severity": 2,
        "nvt": "1.3.6.1.4.1.25623.1.0.815255"
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v2/exceptions' \
--header 'Content-Type: application/json' \
--data-raw '{
    "exception": {
        "text": "My Exception",
        "hosts": "178.151.13.5",
        "port": 8080,
        "task": "4879b8a6-fb3e-4a0d-aef8-b0ea469ac85c",
        "scan": "a7a2f3fe-ff95-4c3f-9ff0-56fb58648122",
        "new_severity": 2,
        "nvt": "1.3.6.1.4.1.25623.1.0.815255"
    }
}'

Responses

🟢201Created

Exception created

This response does not have a body.

🟠401Unauthorized

🟠422Parameter Error

Modified at 2025-04-24 10:59:46

List Exceptions

Update Exception