Method: organizations.reports.create

Creates a Custom Report for an Organization. A Custom Report provides Apigee Customers to create custom dashboards in addition to the standard dashboards which are provided. The Custom Report in its simplest form contains specifications about metrics, dimensions and filters. It is important to note that the custom report by itself does not provide an executable entity. The Edge UI converts the custom report definition into an analytics query and displays the result in a chart.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The parent organization name under which the Custom Report will be created. Must be of the form: organizations/{organizationId}/reports

Authorization requires the following IAM permission on the specified resource parent:

  • apigee.reports.create

Request body

The request body contains an instance of CustomReport.

Response body

If successful, the response body contains a newly created instance of CustomReport.

Authorization scopes

Requires the following OAuth scope: