Delete a Report

Knowledge Center > Reporting and Analytics > Reporting API Reference > Additional Operations > Delete a Report

Delete a Report

Contact Zuora Global Support to enable this feature in your tenant. This feature is currently in development and is subject to change without advance notice.

The Delete a Report Reporting API deletes the report you identify with the ReportId specified by the call.

Specify the ReportId as a request path value for the report you wish to delete as is shown in the example below. You can obtain the ReportId in many different ways. For example the ReportId value is returned as the id value in the JSON response to a call of Search by Report Names, Get Reports by Label, or you can get it definitively from the response to the Create a Report or Save a Report calls.



API Sandbox: 





The Dele a Report POST request body must be submitted as JSON content.  Set the body content type to "application/json" in the request header: Content-Type: application/json

Request Path Parameters




The unique identifier for a report.

You can obtain the ReportId from the id value in the JSON response to a call of Search by Report Names or you can get it definitively from the response to the Create a Report call.

Request Body

No request body is used for the Delete a Report call. 


A successful invocation of Delete a Report will result with a simple JSON response that the invocation was a success and that the report has been deleted. 


HTTPS Request 


JSON Response:

  "success" : true,
  "response" : "The report has been successfully deleted."


An error occurred. The report with ID {XYZ} does not exist. 
"errorCode" : "ZAN-USAGE-REST-ERROR" 

Check that the reportId is correct before submitting again.

This error displays when a report has already been deleted.

<title>Bad Request</title>
<body> That's a bad request </body>
Check the URL for typos.

"message" : "Token could not be decrypted.",
"errorCode" : "loginFailed"

Check authentication header for errors.
Last modified



(not set)