Skip to main content
Version: 8.3 / 3.11.0

Delete reports

The report deletion API allows you to delete reports by ID from Optimize.

Heads up!

During deletion a report will get removed from any dashboard or combined process report it is referenced by. In case a report is referenced by an alert, the corresponding alert will get deleted too.

Method & HTTP target resource

DELETE /api/public/report/{report-ID}

Where report-ID is the ID of the report you wish to delete.

Request headers

The following request headers have to be provided with every delete request:

HeaderConstraintsValue
AuthorizationREQUIREDSee Authorization

Query parameters

No query parameters available.

Request body

No request body is required.

Result

No response body.

Response codes

Possible HTTP response status codes:

CodeDescription
204Request successful.
401Secret incorrect or missing in HTTP Header. See Authorization on how to authenticate.
404The requested report was not found, please check the provided report-ID.
500Some error occurred while processing the request, best check the Optimize log.

Example

Delete a report

Let's assume you want to delete a report with the ID e6c5abb1-6a18-44e7-8480-d562d511ba62, this is what it would look like:

DELETE /api/public/report/e6c5aaa1-6a18-44e7-8480-d562d511ba62

Request header

Authorization: Bearer mySecret

Response

Status 204.