Delete report run

less than a minute

DELETE https://api.digicert.com/reports/v1/report/{{report_identifier}}/{{report_run_identifier}}

Use this endpoint to permanently delete a report run.

After deleting a report run, you can no longer:

View information about the report run.
Download the results of the report run.

If a report has only one entry (for example, an on-demand report that has only run once), deleting the report run (report_run_identifier) also deletes the record for the report (report_identifier).

Warning

If you do not include a report_run_identifier in the URL path, this request permanently deletes the report associated with the report_identifier and all associated report runs. See Delete report.

Example requests and responses

cURL

curl --request DELETE 'https://api.digicert.com/reports/v1/report/{{report_identifier}}/{{report_run_identifier}}' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \

200 OK

{
    "message": "Successfully marked report for deletion"
}

Path parameters

Name	Req/Opt	Description
report_identifier	required	Report ID (UUID). To get the report ID, copy the report_identifier returned when you Create a report. Otherwise, use the List report history endpoint.
report_run_identifier	required	ID of the specific report run to download (UUID). To get the report run ID, use the List report history endpoint.