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.

DELETE/v1.3/registry/

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&registryIds=value2&registryIds=value3, and so on.

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&registryIds=value2&registryIds=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&registryIds=value2, and so on.

API request

    curl -X DELETE 
"<qualys_base_url>/csapi/v1.3/registry?registryIds=8b261e4e-47f3-3b6a-a5a7-668ff0d6e3eb&registryIds=9b251e3e-52f3-2b6a-a6a7-678ff0d5e2eb" --header "Authorization: Bearer <token>"

Response

    {
    "deletionJobId": "1b54a117-b413-4aa8-8511-61860487619c"
}