{
  "opencollection": "1.0.0",
  "info": {
    "name": "Downloads About Scanners API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Authorization",
      "value": "{{Authorization}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Scanners",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List scanners",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/scanners"
          },
          "docs": "Returns the scanner list.<div class=\"perms-callout\">Requires the Scan Manager [40] user role or one of the following custom role privileges: `VM.VM_SENSOR.VM_SCANNER.READ`, `VM.VM_SENSOR.VM_WAS_SCANNER.READ`, or `VM.VM_SENSOR.VM_NETWORK_MONITOR.READ`. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Get scanner details",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/scanners/:scanner_id",
            "params": [
              {
                "name": "scanner_id",
                "value": "",
                "type": "path",
                "description": "The ID of the scanner."
              }
            ]
          },
          "docs": "Returns details for the specified scanner.<div class=\"perms-callout\">Requires the Scan Manager [40] user role or one of the following custom role privileges: `VM.VM_SENSOR.VM_SCANNER.READ`, `VM.VM_SENSOR.VM_WAS_SCANNER.READ`, or `VM.VM_SENSOR.VM_NETWORK_MONITOR.READ`. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Update scanner",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://www.tenable.com/downloads/api/v2/scanners/:scanner_id",
            "params": [
              {
                "name": "scanner_id",
                "value": "",
                "type": "path",
                "description": "The ID of the scanner."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates the specified scanner. \n\nYou cannot use this endpoint to assign the scanner to a network object. Instead, use the [POST /networks/{network_id}/scanners/{scanner_uuid}](ref:networks-assign-scanner) endpoint.<div class=\"perms-callout\">Requires the Scan Manager [40] user role or one of the following custom role privileges: `VM.VM_SENSOR.VM_SCANNER.EDIT`, `VM.VM_SENSOR.VM_WAS_SCANNER.EDIT`, or `VM.VM_SENSOR.VM_NETWORK_MONITOR.EDIT`. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Delete scanner",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://www.tenable.com/downloads/api/v2/scanners/:scanner_id",
            "params": [
              {
                "name": "scanner_id",
                "value": "",
                "type": "path",
                "description": "The ID of the scanner."
              }
            ]
          },
          "docs": "Deletes and unlinks a scanner from Tenable Vulnerability Management.<div class=\"perms-callout\">Requires the Scan Manager [40] user role or one of the following custom role privileges: `VM.VM_SENSOR.VM_SCANNER.DELETE`, `VM.VM_SENSOR.VM_WAS_SCANNER.DELETE`, or `VM.VM_SENSOR.VM_NETWORK_MONITOR.DELETE`. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "Get scanner key",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/scanners/:scanner_id/key",
            "params": [
              {
                "name": "scanner_id",
                "value": "",
                "type": "path",
                "description": "The ID or UUID of the scanner. You can use the default UUID `00000000-0000-0000-0000-00000000000000000000000000001` to retrieve your container's current linking key."
              }
            ]
          },
          "docs": "Retrieves the key of the requested scanner.<div class=\"perms-callout\">Requires the Scan Manager [40] user role or the `VM.VM_SENSOR.LINKING_KEY.READ` custom role privilege. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List AWS scan targets",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/scanners/:scanner_id/aws-targets",
            "params": [
              {
                "name": "scanner_id",
                "value": "",
                "type": "path",
                "description": "The ID of the scanner."
              }
            ]
          },
          "docs": "Lists AWS scan targets if the requested scanner is an Amazon Web Services scanner.<div class=\"perms-callout\">Requires the Scan Manager [40] user role or one of the following custom role privileges: `VM.VM_SENSOR.VM_SCANNER.READ`, `VM.VM_SENSOR.VM_WAS_SCANNER.READ`, or `VM.VM_SENSOR.VM_NETWORK_MONITOR.READ`. See [Roles](doc:roles).</div>"
        },
        {
          "info": {
            "name": "List running scans",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.tenable.com/downloads/api/v2/scanners/:scanner_id/scans",
            "params": [
              {
                "name": "scanner_id",
                "value": "",
                "type": "path",
                "description": "The ID of the scanner."
              }
            ]
          },
          "docs": "Lists scans running on the requested scanner.<div class=\"perms-callout\">Requires the Scan Manager [40] user role or one of the following custom role privileges: `VM.VM_SENSOR.VM_SCANNER.READ`, `VM.VM_SENSOR.VM_WAS_SCANNER.READ`, or `VM.VM_SENSOR.VM_NETWORK_MONITOR.READ`. See [Roles](doc:roles).</div>"
        }
      ]
    }
  ],
  "bundled": true
}