Delete Registries in Your Account
Use this API to delete one or more registries in your account. Note that you cannot delete a registry whose schedules are in the “Running” state.
You can choose to provide a request body without parameters or you can specify UUIDs as input parameters in the API request.
Request Body ParametersRequest Body Parameters
When specifying the request body:
|
Parameter |
Mandatory/Optional |
Data Type |
Description |
|---|---|---|---|
|
registryDeleteRequest |
Mandatory |
string |
Provide one or more registry UUIDs for the registries you want to delete. |
Input ParametersInput Parameters
When specifying input parameters as part of the path:
|
Parameter |
Mandatory/Optional |
Data Type |
Description |
|---|---|---|---|
|
registryIds |
Mandatory |
array[string] |
Provide one or more registry UUIDs for the registries you want to delete. When specifying multiple registries in the same request, enter them in this way: registryIds=value1®istryIds=value2®istryIds=value3, and so on. |
Sample 1 - Use the request body to specify registries to deleteSample 1 - Use the request body to specify registries to delete
In this sample, a request body is used as part of the API request.
API request
curl -X DELETE
"<qualys_base_url>/csapi/v1.3/registry" -d "{"registryIds":["95b715e0-0fc7-4dac-b4de-2e1b92fc527d"]}" --header "Authorization: Bearer <token>"
Response
Returns {
"deletionJobId": "980ce235-5677-4997-81ca-3905e63471bb"
}
Sample 2 - Delete a single registry using registry UUIDSample 2 - Delete a single registry using registry UUID
In this sample, we’ll delete a single registry by specifying the UUID as input parameter.
API request
curl -X DELETE
"<qualys_base_url>/csapi/v1.3/registry?registryIds=8b261e4e-47f3-3b6a-a5a7-668ff0d6e3eb" --header "Authorization: Bearer <token>"
Response
{
"deletionJobId": "8b04c56a-33ad-44ba-a128-fc643b0af3c7"
}
Sample 3 - Delete multiple registries using registry UUIDsSample 3 - Delete multiple registries using registry UUIDs
In this sample, we’ll delete 2 registries in the same request. Specify multiple registries by entering registryIds=value1®istryIds=value2, and so on.
API request
curl -X DELETE
"<qualys_base_url>/csapi/v1.3/registry?registryIds=8b261e4e-47f3-3b6a-a5a7-668ff0d6e3eb®istryIds=9b251e3e-52f3-2b6a-a6a7-678ff0d5e2eb" --header "Authorization: Bearer <token>"
Response
{
"deletionJobId": "1b54a117-b413-4aa8-8511-61860487619c"
}