DocumentationAPI ExplorerRecipesConnectChangelogRSSSubscribe
API Explorer

Convert credentials

post
https://cloud.tenable.com/scans//credentials//upgrade

Converts scan-specific credentials to managed credentials. For more information, see Convert Scan-specific Credentials to Managed Credentials.

Requires the Scan Manager [40] user role and Can Edit [64] scan permissions. See Roles and Permissions.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

The ID of the scan where the scan-specific credentials are currently stored.

integer
required

The ID of the scan-specific credentials. For more information about determining this ID, see Convert Scan-specific Credentials to Managed Credentials.

Body Params
string
required

The name of the managed credentials. This name must be unique within your Tenable Vulnerability Management instance.

settings
object
required

The configuration settings for the credentials. The parameters of this object vary depending on the credentials type. For more information, see Determine Settings for a Credential Type.

Note: This form displays limited parameters that support a Windows type of credentials that uses password authentication.

string
required

The system name that uniquely identifies the credentials type, for example, Windows.

string
required

The system name that uniquely identifies the credentials category, for example Host.

boolean
required

A value specifying whether the credentials are scan-specific (true) or managed (false). You must use false for this request body attribute to convert scan-specific to managed credentials.

permissions
array of objects

A list of user permissions for the managed credentials. If a request message omits this parameter, Tenable Vulnerability Management automatically creates a permissions object for the user account that submits the request.

permissions
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

400

Returned if Tenable Vulnerability Management encounters invalid JSON in request body.

403

Returned if you do not have permission to convert scan-specific credentials to managed credentials.

409

Returned if managed credentials with the same name already exist.

415

Returned if the request payload is in an unsupported format.

Updated about 1 month ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/html

Updated about 1 month ago