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

Examples

Responses

🟢201Created

Exception created

This response does not have a body.

🟠401Unauthorized

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

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"
    }
}'

Response Example

401 - Example 1

{
    "errors": [
        {
            "message": "string",
            "type": "string",
            "timestamp": "string"
        }
    ]
}

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

List Exceptions

Update Exception

Create Exception

Scope by Host and Port:#

Scope by Scan:#

Request

Responses

Scope by Host and Port:

Scope by Scan: