Delete profile

delete

https://cloud.tenable.com/sensors/profiles/{sensor_type}/{profile_uuid}

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.

You can monitor the status of deletion request via the Get agent task status or Get scanner task status endpoint.

Note: If the agent or scanner profile has any assigned agents or scanners, they will be reassigned to the default agent or scanner profile.

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

403

Returned if you do not have permission to delete profiles.

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/html

200Returned if the specified profile was deleted successfully.

400Returned if your request specified invalid parameters or if your request was improperly formatted.

401Returned if the API keys specified in your request are invalid.

404Returned if the specified profile was not found.

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

500Returned if an internal error occurred.