Delete report run


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).

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 --request DELETE '{{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. 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 delete. To get the report run ID, use the List report history endpoint.

Response parameters

Name Type Description
message string Deletion message.