Skip to main content

Delete Report

Permanently delete a saved report.
This only deletes the saved report configuration. The underlying analytics data remains intact.

Endpoint

DELETE /api/reports/{reportId}

Headers

Authorization
string
required
Bearer token for authentication

Path Parameters

reportId
string
required
Report UUID to delete

Response

Returns a 200 OK status with an empty response body on successful deletion.

Example Request

curl -X DELETE https://your-umami-instance.com/api/reports/dd0e8400-e29b-41d4-a716-446655440008 \
  -H "Authorization: Bearer YOUR_TOKEN"

Error Responses

401
error
Unauthorized - You don’t have permission to delete this report
404
error
Not Found - Report does not exist

What Gets Deleted

When you delete a report:
  • The saved report configuration is permanently removed
  • Analytics data is NOT deleted
  • You can recreate the report with the same parameters later

Permissions

You must have delete permissions for the website that owns this report.

Build docs developers (and LLMs) love