Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Tenable Remediation Scans API

The Remediation Scans API from Tenable — 1 operation(s) for remediation scans.

Tenable Remediation Scans API is one of 107 APIs that Tenable publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Remediation Scans. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 2 operations across 1 path, and defines 19 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against a single base URL, https://www.tenable.com/downloads/api/v2.

2 operations 1 paths 19 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://cloud.tenable.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Tenable Remediation Scans API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Bearer). By default, every request must be authenticated.

  • Bearer — Example: Bearer {{token}}

Paths & Operations 2

Across 1 path, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Remediation Scans 2
POST
/scans/remediation
Create remediation scan
io-scans-remediation-create body → 200400401403429500
GET
/scans/remediation
List remediation scans
io-scans-remediation-list 3 params → 200401429500

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are Remediation_Scans_Request-ScanSettings-Assessment (57 properties), Remediation_Scans_Request-ScanSettings-Advanced (54 properties), Remediation_Scans_scan-object-create-update-response (38 properties), Remediation_Scans_Request-ScanSettings-Discovery (34 properties). Each schema is shown below with its type and property counts.

Remediation_Scans_PaginationResponse
object
An object containing pagination information for the current result set.
4 properties
Remediation_Scans_request-create-scan-credentials-object
object
An object that specifies credential parameters that enable a scanner to authenticate a connection to a target host. For more information about using managed cr…
1 property
Remediation_Scans_settings-rrules
string
The interval at which the scan repeats. The interval is formatted as a string of three values delimited by semi-colons. These values are: the frequency (FREQ=O…
Remediation_Scans_settings-scan-triggers
array
For Nessus Agent scans, describes the scan triggers used when agentscanlaunchtype is set to triggered.
Remediation_Scans_Request-ScanSettings-Basic
object
Basic scan configuration settings including name, description, targets, scanner assignment, and notifications.
30 properties 1 required
Remediation_Scans_scan-object-create-update-response
object
38 properties
Remediation_Scans_Request-ScanSettings-Schedule
object
Settings that control when and how often the scan runs.
7 properties
Remediation_Scans_Request-ScanSettings-Report
object
Settings that control how scan results are reported and displayed.
7 properties
Remediation_Scans_enabled_plugins
array
Specifies a list of plugin IDs to add to a remediation scan. You can use the [List plugin families](ref:io-plugins-families-list) and [List plugins in family](…
Remediation_Scans_settings-agent-scan-launch-type
string
For Nessus Agent scans, indicates whether the agent scan should use the scan window (scheduled) or rule-based (triggered) method for scan launches.
Remediation_Scans_Request-ScanSettings
object
Complete scan settings for creating or updating a scan configuration.
Remediation_Scans_settings-acls
object
6 properties
Remediation_Scans_Request-ScanSettings-Assessment
object
Settings that control vulnerability assessment behavior including accuracy, brute force, SCADA, web application scanning, Windows enumeration, malware scanning…
57 properties
Remediation_Scans_PaginationResponseSortObject
object
An object specifying how the current result set is sorted, including the property by which the results were sorted and the sort direction.
2 properties
Remediation_Scans_Request-ScanSettings-Advanced
object
Settings that control general scan behavior, performance, debugging, compliance output, vulnerability options, and credential handling.
54 properties
Remediation_Scans_Request-ScanSettings-Discovery
object
Settings that control how the scanner discovers hosts, including host discovery, ping methods, port scanning, service discovery, and identity collection.
34 properties
Remediation_Scans_ErrorResponse
object
3 properties
Remediation_Scans_remediation-scan-object-list
object
22 properties
Remediation_Scans_request-create-and-update-plugins-object
object
A list of plugins to add to the non-remediation scans. Use the [List plugin families](ref:io-plugins-families-list) endpoint to get a list of plugin families t…
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tenable-remediation-scans-api-openapi.yml Raw ↑

Other APIs Tenable publishes across the network.

Tenable About API
Tenable Access Control (API) API
Tenable Access Control (Groups) API
Tenable Access Control (Permissions) API
Tenable Access Control (Roles) API
Tenable Access Control (Users) API
Tenable Access Groups v1 API
Tenable Access Groups v2 API
Tenable Account Groups API
Tenable Accounts API
Tenable Activity Log API
Tenable AD object API