Tenable Profiles API
The Profiles API from Tenable — 4 operation(s) for profiles.
OpenAPI Specification
openapi: 3.0.0
info:
version: 1.0.0
title: Downloads About Profiles API
description: 'The Downloads API enables customers to access and download installation and update files for available Tenable products. You can use the API endpoints to list product pages, list downloads available for a specific product, and to download a file. The endpoints can also be used to determine and download the latest version of a file to facilitate the automation of an installation.
**Note:** The Tenable Downloads API uses a different server URL than the Tenable Vulnerability Management API:
`https://www.tenable.com/downloads/api/v2/pages`.
### Authentication
Like the Downloads website, certain files require authentication to download. When files have a `"requires_auth": true` attribute on the product list page, the Downloads API uses bearer token authentication and requires a valid token in the Authorization header to download the file:
```
Authorization: Bearer AbCdEf123456
```
To access or reset your authentication token, navigate to the [Authentication Token](https://www.tenable.com/downloads/api-docs) page.
Examples of product downloads that **do not** require authentication include Nessus and Nessus Agents.'
servers:
- url: https://www.tenable.com/downloads/api/v2
security:
- Bearer: []
tags:
- name: Profiles
x-displayName: Profiles
paths:
/sensors/profiles/{sensor_type}:
post:
summary: Create profile
description: "Creates a new profile. The type of profile created depends on the `sensor_type` path parameter, which can be set to either `agent` or `scanners`. \n\n**Note:** You can assign or remove an agent from an agent profile using the [Assign or remove agent profile](ref:agent-bulk-operations-profile) endpoint. For scanners, use the [Assign to scanner profile](ref:scanner-profile-assign-bulk) and [Remove from scanner profile](ref:scanner-profile-remove-bulk) endpoints.<div class=\"perms-callout\">Requires the Scan Manager [40] user role. See [Roles](doc:roles).</div>"
operationId: profiles-create
tags:
- Profiles
parameters:
- $ref: '#/components/parameters/Profiles_sensor_type-path-param'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_request-create-profile'
responses:
'200':
description: Returned if the profile was created successfully.
content:
application/json:
schema:
type: object
properties:
uuid:
description: The unique identifier (UUID) of the new profile.
type: string
format: uuid
examples:
response:
value:
uuid: ed52a53d-658f-4a22-8ea7-e21d0d530e9c
'400':
description: Returned if your request specified invalid parameters or if your request was improperly formatted.
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: A brief description of the error.
examples:
response:
value:
error: Invalid sensor type scannera
'401':
description: Returned if the API keys specified in your request are invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_ErrorResponse'
examples:
response:
value:
statusCode: 401
error: Unauthorized
message: Invalid credentials.
'403':
description: Returned if you do not have permission to create profiles.
'429':
description: Returned if you attempt to send too many requests in a specific period of time. For more information, see [Rate Limiting](doc:rate-limiting).
content:
text/html:
examples:
response:
value: "<html>\n\n<head>\n <title>429 Too Many Requests</title>\n</head>\n\n<body bgcolor=\"white\">\n <center>\n <h1>429 Too Many Requests</h1>\n </center>\n <hr>\n <center>nginx</center>\n</body>\n\n</html>"
'500':
description: Returned if an internal error occurred.
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_ErrorResponse'
examples:
response:
value:
statusCode: 500
error: Internal Server Error
message: An internal server error occurred. Please wait a moment and try your request again.
security:
- Profiles_cloud: []
get:
summary: List profiles
description: 'Returns a list of profiles. The type of profiles returned depends on the `sensor_type` path parameter, which can be set to either `agent` or `scanners`. <div class="perms-callout">Requires the Scan Operator [24] user role or one of the following custom role privileges: `VM.VM_SENSOR.VM_AGENT.READ` for agent profiles or `VM.VM_SENSOR.VM_SCANNER.READ` for scanner profiles. See [Roles](doc:roles).</div>'
operationId: profiles-list
tags:
- Profiles
parameters:
- $ref: '#/components/parameters/Profiles_sensor_type-path-param'
responses:
'200':
description: Returned if the list of profiles was retrieved successfully.
content:
application/json:
schema:
type: object
description: An object containing an array of profile objects.
properties:
profiles:
$ref: '#/components/schemas/Profiles_response-profiles'
examples:
Agent Profile Response:
value:
profiles:
- name: US-1A Sensors
description: This profile targets sensors for US-1A.
profile_uuid: 52cddf58-f10f-49f6-969f-d17f623171f5
created: '2024-07-19T00:11:47.227483Z'
updated: '2024-07-19T00:11:47.227483Z'
config:
version: 11.0.0
immediate_plugin_update: true
update_disabled: false
container_public_key: '-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEArvPm3nYSduF7eHNcAp5i
EgL0f1Pp2Kp304vAQRjaURlNN1jKUCBV8IgCVLM9IJZ5u153pEFgyk9sNVZgVq9m
Ut3yfJ4HtWQwYYo1v5Cv4Ir7hRh18J2uDQAHhAJZXfc8rTTVZqaCh5iEh+shdPc6
YP4Qmb0Z1d1b0CaMBHyNm3ATUfZDMb8v3tVcj6BYG7Oovx45XdF4xnW19tOFUeXH
pGkNRvalNeWphke+GgLeAqItSKfH6sctTB8dUG6ENqXmp20ZiXE4mzTDS7MTQs/Y
yiZYvjcLSO6isQPh9ndoCSfB2tEvbW/48MdJJ0vrHS0HWb0Ninu6MUSU6ijvA5AF
9MMo/Rd/h2dQ71AnzKN43IxFx53PUshHyMTbTXDYCoRKTRHb4P+k9jwc3YsHjdVE
yCQI0AyNmTY5x6qxqS45tIQO3GbFINv9GjEW3eGtFerJEXdySwiFwVoWz5A98TVO
hcJupa4jV2Qglp2gDMoRC+zakncVTHusxo8e3aYHeVH8Rcv0aMKClc0gx0F6BgcV
yljgQWZER6dIWfS5utbJbQhpPPdoWZ5O+4TJYhenD77Bg3wQC/HC2whDKp4nSnpb
1r9QPlS1frdl5fLclbxHwjCHYmRMI5EHwjtzx0rTeOqYmqwL3/PzNDz6A3gLB0CB
8hFQtVB3tUl1uQD5xQdyiwkCAwEAAQ==
-----END PUBLIC KEY-----
'
modules:
com.tenable.nessus_agent:
enabled: true
settings:
- setting: backend_log_level
value: normal
com.tenable.agent_identifier_service:
enabled: true
open_agent_port: 5050
com.tenable.fredi_module:
enabled: true
base_inventory_freq: 2
com.tenable.tua_comm_module:
enabled: true
resources:
cpu_quota: 30
- name: Laptop sensors
description: Agents installed on laptops.
profile_uuid: 5aa47f9a-bc02-404a-84d1-f54a30c5c652
created: '2024-07-19T02:15:26.668164Z'
updated: '2024-07-19T02:15:26.668164Z'
config:
version: 11.0.0
immediate_plugin_update: true
update_disabled: false
container_public_key: '-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEArvPm3nYSduF7eHNcAp5i
EgL0f1Pp2Kp304vAQRjaURlNN1jKUCBV8IgCVLM9IJZ5u153pEFgyk9sNVZgVq9m
Ut3yfJ4HtWQwYYo1v5Cv4Ir7hRh18J2uDQAHhAJZXfc8rTTVZqaCh5iEh+shdPc6
YP4Qmb0Z1d1b0CaMBHyNm3ATUfZDMb8v3tVcj6BYG7Oovx45XdF4xnW19tOFUeXH
pGkNRvalNeWphke+GgLeAqItSKfH6sctTB8dUG6ENqXmp20ZiXE4mzTDS7MTQs/Y
yiZYvjcLSO6isQPh9ndoCSfB2tEvbW/48MdJJ0vrHS0HWb0Ninu6MUSU6ijvA5AF
9MMo/Rd/h2dQ71AnzKN43IxFx53PUshHyMTbTXDYCoRKTRHb4P+k9jwc3YsHjdVE
yCQI0AyNmTY5x6qxqS45tIQO3GbFINv9GjEW3eGtFerJEXdySwiFwVoWz5A98TVO
hcJupa4jV2Qglp2gDMoRC+zakncVTHusxo8e3aYHeVH8Rcv0aMKClc0gx0F6BgcV
yljgQWZER6dIWfS5utbJbQhpPPdoWZ5O+4TJYhenD77Bg3wQC/HC2whDKp4nSnpb
1r9QPlS1frdl5fLclbxHwjCHYmRMI5EHwjtzx0rTeOqYmqwL3/PzNDz6A3gLB0CB
8hFQtVB3tUl1uQD5xQdyiwkCAwEAAQ==
-----END PUBLIC KEY-----
'
modules:
com.tenable.agent_identifier_service:
enabled: false
com.tenable.fredi_module:
enabled: true
base_inventory_freq: 1
com.tenable.tua_comm_module:
enabled: true
- name: Headquarters
description: Agents on assets at headquarters.
profile_uuid: 97108036-2262-4dc2-997e-2a1d0cd9904f
created: '2024-07-19T02:14:47.447461Z'
updated: '2024-07-19T02:14:47.447461Z'
config:
version: 10.6.4
pluginset: '202407181903'
update_disabled: false
container_public_key: '-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEArvPm3nYSduF7eHNcAp5i
EgL0f1Pp2Kp304vAQRjaURlNN1jKUCBV8IgCVLM9IJZ5u153pEFgyk9sNVZgVq9m
Ut3yfJ4HtWQwYYo1v5Cv4Ir7hRh18J2uDQAHhAJZXfc8rTTVZqaCh5iEh+shdPc6
YP4Qmb0Z1d1b0CaMBHyNm3ATUfZDMb8v3tVcj6BYG7Oovx45XdF4xnW19tOFUeXH
pGkNRvalNeWphke+GgLeAqItSKfH6sctTB8dUG6ENqXmp20ZiXE4mzTDS7MTQs/Y
yiZYvjcLSO6isQPh9ndoCSfB2tEvbW/48MdJJ0vrHS0HWb0Ninu6MUSU6ijvA5AF
9MMo/Rd/h2dQ71AnzKN43IxFx53PUshHyMTbTXDYCoRKTRHb4P+k9jwc3YsHjdVE
yCQI0AyNmTY5x6qxqS45tIQO3GbFINv9GjEW3eGtFerJEXdySwiFwVoWz5A98TVO
hcJupa4jV2Qglp2gDMoRC+zakncVTHusxo8e3aYHeVH8Rcv0aMKClc0gx0F6BgcV
yljgQWZER6dIWfS5utbJbQhpPPdoWZ5O+4TJYhenD77Bg3wQC/HC2whDKp4nSnpb
1r9QPlS1frdl5fLclbxHwjCHYmRMI5EHwjtzx0rTeOqYmqwL3/PzNDz6A3gLB0CB
8hFQtVB3tUl1uQD5xQdyiwkCAwEAAQ==
-----END PUBLIC KEY-----
'
modules:
com.tenable.agent_identifier_service:
enabled: false
com.tenable.fredi_module:
enabled: true
base_inventory_freq: 1
com.tenable.tua_comm_module:
enabled: true
- name: Default
description: Used for agents not assigned to a user-defined profile
profile_uuid: 00000000-0000-0000-0000-000000000000
created: '2024-07-19T02:15:38.879127Z'
updated: '2024-07-19T02:15:38.879136Z'
config: {}
Scanner Profile Response:
value:
profiles:
- name: Office Scanners
description: This profile targets office scanners.
profile_uuid: 0b1bee7a-8bf9-4437-acff-935c1e71ee23
created: '2025-10-29T20:34:47.532930Z'
updated: '2025-10-29T20:34:47.532930Z'
config:
version: 10.10.1
pluginset: latest
update_disabled: false
- name: Remote Scanners
profile_uuid: d17eca8a-e751-4f59-a71e-1ef37db8283c
created: '2025-10-29T20:36:52.247030Z'
updated: '2025-10-29T20:36:52.247030Z'
config:
version: '10.10'
pluginset: '10'
update_disabled: true
- name: Default
description: Used for scanners not assigned to a user-defined profile
profile_uuid: 00000000-0000-0000-0000-000000000000
created: '2025-10-29T23:04:43.701984Z'
updated: '2025-10-29T23:04:43.701992Z'
config: {}
'401':
description: Returned if the API keys specified in your request are invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_ErrorResponse'
examples:
response:
value:
statusCode: 401
error: Unauthorized
message: Invalid credentials.
'403':
description: Returned if you do not have permission to list profiles.
'429':
description: Returned if you attempt to send too many requests in a specific period of time. For more information, see [Rate Limiting](doc:rate-limiting).
content:
text/html:
examples:
response:
value: "<html>\n\n<head>\n <title>429 Too Many Requests</title>\n</head>\n\n<body bgcolor=\"white\">\n <center>\n <h1>429 Too Many Requests</h1>\n </center>\n <hr>\n <center>nginx</center>\n</body>\n\n</html>"
'500':
description: Returned if an internal error occurred.
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_ErrorResponse'
examples:
response:
value:
statusCode: 500
error: Internal Server Error
message: An internal server error occurred. Please wait a moment and try your request again.
security:
- Profiles_cloud: []
/sensors/profiles/{sensor_type}/{profile_uuid}:
get:
summary: Get profile details
description: 'Retrieves details for the specified profile. The type of profile returned depends on the `sensor_type` path parameter, which can be set to either `agent` or `scanners`. <div class="perms-callout">Requires the Scan Operator [24] user role or one of the following custom role privileges: `VM.VM_SENSOR.VM_AGENT.READ` for agent profiles or `VM.VM_SENSOR.VM_SCANNER.READ` for scanner profiles. See [Roles](doc:roles).</div>'
operationId: profiles-details
tags:
- Profiles
parameters:
- $ref: '#/components/parameters/Profiles_sensor_type-path-param'
- $ref: '#/components/parameters/Profiles_profile_uuid-path-param'
responses:
'200':
description: Returned if the details for the specified profile were retrieved successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_response-sensor-type-profile'
examples:
Agent Profile Details Response:
value:
name: US-1A Sensors
description: This profile targets sensors for US-1A.
profile_uuid: 52cddf58-f10f-49f6-969f-d17f623171f5
created: '2024-07-19T00:11:47.227483Z'
updated: '2024-07-19T00:11:47.227483Z'
config:
version: 11.0.0
immediate_plugin_update: true
update_disabled: false
container_public_key: '-----BEGIN PUBLIC KEY-----
MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEArvPm3nYSduF7eHNcAp5i
EgL0f1Pp2Kp304vAQRjaURlNN1jKUCBV8IgCVLM9IJZ5u153pEFgyk9sNVZgVq9m
Ut3yfJ4HtWQwYYo1v5Cv4Ir7hRh18J2uDQAHhAJZXfc8rTTVZqaCh5iEh+shdPc6
YP4Qmb0Z1d1b0CaMBHyNm3ATUfZDMb8v3tVcj6BYG7Oovx45XdF4xnW19tOFUeXH
pGkNRvalNeWphke+GgLeAqItSKfH6sctTB8dUG6ENqXmp20ZiXE4mzTDS7MTQs/Y
yiZYvjcLSO6isQPh9ndoCSfB2tEvbW/48MdJJ0vrHS0HWb0Ninu6MUSU6ijvA5AF
9MMo/Rd/h2dQ71AnzKN43IxFx53PUshHyMTbTXDYCoRKTRHb4P+k9jwc3YsHjdVE
yCQI0AyNmTY5x6qxqS45tIQO3GbFINv9GjEW3eGtFerJEXdySwiFwVoWz5A98TVO
hcJupa4jV2Qglp2gDMoRC+zakncVTHusxo8e3aYHeVH8Rcv0aMKClc0gx0F6BgcV
yljgQWZER6dIWfS5utbJbQhpPPdoWZ5O+4TJYhenD77Bg3wQC/HC2whDKp4nSnpb
1r9QPlS1frdl5fLclbxHwjCHYmRMI5EHwjtzx0rTeOqYmqwL3/PzNDz6A3gLB0CB
8hFQtVB3tUl1uQD5xQdyiwkCAwEAAQ==
-----END PUBLIC KEY-----
'
modules:
com.tenable.nessus_agent:
enabled: true
settings:
- setting: backend_log_level
value: normal
com.tenable.agent_identifier_service:
enabled: true
open_agent_port: 5050
com.tenable.fredi_module:
enabled: true
base_inventory_freq: 2
com.tenable.tua_comm_module:
enabled: true
resources:
cpu_quota: 30
Scanner Profile Details Response:
value:
name: Office Scanners
description: This profile targets office scanners.
profile_uuid: 0b1bee7a-8bf9-4437-acff-935c1e71ee23
created: '2025-10-29T20:34:47.532930Z'
updated: '2025-10-29T20:34:47.532930Z'
config:
version: 10.10.1
pluginset: latest
update_disabled: false
'401':
description: Returned if the API keys specified in your request are invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_ErrorResponse'
examples:
response:
value:
statusCode: 401
error: Unauthorized
message: Invalid credentials.
'403':
description: Returned if you do not have permission to retrieve profile details.
'404':
description: Returned if the specified profile was not found.
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: A brief description of the error.
examples:
response:
value:
error: Profile 52cddf58-f10f-49f6-969f-d17f623171a4 not found
'429':
description: Returned if you attempt to send too many requests in a specific period of time. For more information, see [Rate Limiting](doc:rate-limiting).
content:
text/html:
examples:
response:
value: "<html>\n\n<head>\n <title>429 Too Many Requests</title>\n</head>\n\n<body bgcolor=\"white\">\n <center>\n <h1>429 Too Many Requests</h1>\n </center>\n <hr>\n <center>nginx</center>\n</body>\n\n</html>"
'500':
description: Returned if an internal error occurred.
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_ErrorResponse'
examples:
response:
value:
statusCode: 500
error: Internal Server Error
message: An internal server error occurred. Please wait a moment and try your request again.
security:
- Profiles_cloud: []
put:
summary: Update profile
description: 'Updates the specified profile. The type of profile to update depends on the `sensor_type` path parameter, which can be set to either `agent` or `scanners`. <div class="perms-callout">Requires the Scan Manager [40] user role or one of the following custom role privileges: `VM.VM_SENSOR.VM_AGENT.EDIT` for agent profiles or `VM.VM_SENSOR.VM_SCANNER.EDIT` for scanner profiles. See [Roles](doc:roles).</div>'
operationId: profiles-update
tags:
- Profiles
parameters:
- $ref: '#/components/parameters/Profiles_sensor_type-path-param'
- $ref: '#/components/parameters/Profiles_profile_uuid-path-param'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_request-create-profile'
responses:
'200':
description: Returned if the specified profile was updated successfully.
content:
application/json:
examples:
response:
value: {}
'400':
description: Returned if your request specified invalid parameters or if your request was improperly formatted.
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: A brief description of the error.
examples:
response:
value:
error: Invalid sensor type scannera
'401':
description: Returned if the API keys specified in your request are invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_ErrorResponse'
examples:
response:
value:
statusCode: 401
error: Unauthorized
message: Invalid credentials.
'403':
description: Returned if you do not have permission to create profiles.
'404':
description: Returned if the specified profile was not found.
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: A brief description of the error.
examples:
response:
value:
error: Profile 7771248c-508a-4ef0-9934-d390eeecf84b to update not found
'429':
description: Returned if you attempt to send too many requests in a specific period of time. For more information, see [Rate Limiting](doc:rate-limiting).
content:
text/html:
examples:
response:
value: "<html>\n\n<head>\n <title>429 Too Many Requests</title>\n</head>\n\n<body bgcolor=\"white\">\n <center>\n <h1>429 Too Many Requests</h1>\n </center>\n <hr>\n <center>nginx</center>\n</body>\n\n</html>"
'500':
description: Returned if an internal error occurred.
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_ErrorResponse'
examples:
response:
value:
statusCode: 500
error: Internal Server Error
message: An internal server error occurred. Please wait a moment and try your request again.
security:
- Profiles_cloud: []
delete:
summary: Delete profile
description: "Deletes the specified profile. The type of profile to delete depends on the `sensor_type` path parameter, which can be set to either `agent` or `scanners`.\n\nYou can monitor the status of deletion request via the [Get agent task status](ref:bulk-task-agent-status) or [Get scanner task status](ref:scanner-task-status) endpoint. \n\n**Note:** If the agent or scanner profile has any assigned agents or scanners, they will be reassigned to the default agent or scanner profile.<div class=\"perms-callout\">Requires the Scan Manager [40] user role or one of the following custom role privileges: `VM.VM_SENSOR.VM_AGENT.DELETE` for agent profiles or `VM.VM_SENSOR.VM_SCANNER.DELETE` for scanner profiles. See [Roles](doc:roles).</div>"
operationId: profiles-delete
tags:
- Profiles
parameters:
- $ref: '#/components/parameters/Profiles_sensor_type-path-param'
- $ref: '#/components/parameters/Profiles_profile_uuid-path-param'
responses:
'200':
description: Returned if the specified profile was deleted successfully.
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/Profiles_response-agent-profile-deletion'
- $ref: '#/components/schemas/Profiles_response-scanner-profile-deletion'
examples:
Agent Profile Deletion:
value:
task_id: 7azae2f3-544d-497f-b0f0-447d03z7cd55
container_uuid: 3cz182bb-b8ba-4025-9e59-9a81b8a64z5a
status: NEW
message: Deleting profile and assigning agents of the deleted profile to the default profile
Scanner Profile Deletion:
value:
message: Request has been received.
request_status_id: 908ab186-e188-47b4-96f4-131cd52adfee
'400':
description: Returned if your request specified invalid parameters or if your request was improperly formatted.
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: A brief description of the error.
examples:
response:
value:
error: Invalid sensor type scannera
'401':
description: Returned if the API keys specified in your request are invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_ErrorResponse'
examples:
response:
value:
statusCode: 401
error: Unauthorized
message: Invalid credentials.
'403':
description: Returned if you do not have permission to delete profiles.
'404':
description: Returned if the specified profile was not found.
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: A brief description of the error.
examples:
response:
value:
error: Profile UUID not found
'429':
description: Returned if you attempt to send too many requests in a specific period of time. For more information, see [Rate Limiting](doc:rate-limiting).
content:
text/html:
examples:
response:
value: "<html>\n\n<head>\n <title>429 Too Many Requests</title>\n</head>\n\n<body bgcolor=\"white\">\n <center>\n <h1>429 Too Many Requests</h1>\n </center>\n <hr>\n <center>nginx</center>\n</body>\n\n</html>"
'500':
description: Returned if an internal error occurred.
content:
application/json:
schema:
$ref: '#/components/schemas/Profiles_ErrorResponse'
examples:
response:
value:
statusCode: 500
error: Internal Server Error
message: An internal server error occurred. Please wait a moment and try your request again.
security:
- Profiles_cloud: []
/sensors/profiles/{sensor_type}/{profile_uuid}/clone:
post:
summary: Clone profile
description: Creates a copy of an existing profile. The type of profile to clone depends on the `sensor_type` path parameter, which can be set to either `agent` or `scanners`. <div class="perms-callout">Requires the Scan Manager [40] user role. See [Roles](doc:roles).</div>
operationId: profiles-clone
tags:
- Profiles
parameters:
- $ref: '#/components/parameters/Profiles_sensor_type-path-param'
- $ref: '#/components/parameters/Profiles_profile_uuid-path-param'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
description: A name for the profile.
type: string
example: US-1A Sensors
description:
description: A short description explaining the purpose or targets of the profile.
type: string
example: This profile targets sensors for US-1A.
required:
- name
responses:
'200':
description: Returned if the specified profile was successfully cloned.
content:
application/json:
schema:
type: object
properties:
uuid:
description: The unique identifier (UUID) of the cloned profile.
type: string
format: uuid
examples:
response:
value:
uuid: ed52a53d-658f-4a22-8ea7-e21d0d530e9c
'400':
description: Returned if your request specified invalid parameters or if your request was improperly formatted.
content:
application/json:
schema:
type: object
properties:
error:
type: string
description: A brief description of the error.
examples:
response:
value:
# --- truncated at 32 KB (61 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/tenable/refs/heads/main/openapi/tenable-profiles-api-openapi.yml