Create managed credential

post

https://cloud.tenable.com/credentials

Creates a managed credential object that you can use when configuring and running scans. You can grant other users the permission to use the managed credential object in scans and to edit the managed credential configuration.

Requires the Basic [16] user role or the VM.VM_SCAN.VM_SCAN_MANAGED_CREDENTIAL.CREATE custom role privilege. See Roles.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

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

description

string

The description of the managed credential object.

type

string

required

The type of credential object. For a list of supported credential types, use the GET /credentials/types endpoint.

settings

object

required

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

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

permissions

array of objects

A list of user permissions for the managed credential. 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.

401

Returned if Tenable Vulnerability Management cannot authenticate the user account that submitted the request.

403

Returned if you do not have permission to create managed credential objects.

409

Returned if a managed credential object with the same name already exists.

415

Returned if the request payload is in an unsupported format.

200Returned if Tenable Vulnerability Management successfully creates a managed credential object.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

500Returned if Tenable Vulnerability Management encountered an internal server error. Wait a moment, and try your request again.

503Returned if a Tenable Vulnerability Management service is unavailable. Wait a moment, and try your request again.