List managed credentials
GET {{baseUrl}}/credentials?f=deserunt&ft=deserunt&referrer_owner_uuid=deserunt&limit=67454373&offset=67454373&sort=deserunt
Lists managed credentials where you have been assigned at least CAN USE (32) permissions.
Note: This endpoint does not list scan-specific or policy-specific credentials (that is, credentials stored in either a scan or a policy). To view a list of scan-specific or policy-specific credentials, use the editor details endpoint (GET /editor/{type}/{id}).
Requires CAN USE [32] credential permissions. See Permissions.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
f | string | A filter condition in the following format: field:operator:value . For managed credentials, you can only filter on the name field, using the following operators: |
- eq—The name of the returned credential is equal to the text you specify.
- neq—The returned list of managed credentials excludes the credential object where the name is equal to the text you specify.
- match—The returned list includes managed credentials where the name contains the text you specify at least partially.
You can specify multiple f
parameters, separated by ampersand (&) characters. If you specify multiple f
parameters, use the ft
parameter to specify how Tenable.io applies the multiple filter conditions. |
| ft
| string | | The operator that Tenable.io applies if multiple `f` parameters are present. The OR
operator is the only supported value. If you omit this parameter and multiple f
parameters are present, Tenable.io applies the OR
operator by default. |
| referrer_owner_uuid
| string | | The UUID of a scan owner. This parameter limits the returned data to managed credentials assigned to scans owned by the specified user. |
| limit
| number | | The number of records to retrieve. If this parameter is omitted, Tenable.io uses the default value of 50
. |
| offset
| number | | The starting record to retrieve. If this parameter is omitted, Tenable.io uses the default value of 0
. |
| sort
| string | | The field you want to use to sort the results by along with the sort order. The field is specified first, followed by a colon, and the order is specified second (asc
or desc
). For example, name:asc
would sort results by the name
field in ascending order. |
RESPONSES
status: OK
{"credentials":[{"uuid":"aa43b17c-ee05-4369-95f7-af8f9bd8cad0","name":"Windows devices (Headquarters)","description":"Use for scans of Windows devices located at headquarters.","category":{"id":"Host","name":"Host"},"type":{"id":"Windows","name":"Windows"},"created_date":1551295980,"created_by":{"id":15,"display_name":"user@example.com"},"last_used_by":{"id":null,"display_name":null},"permission":32,"user_permissions":32}],"pagination":{"total":1,"limit":50,"offset":0,"sort":[{"name":"created_date","order":"desc"}]}}