---
title: "POST /v1/{+parent}/reports"
method: POST
path: "/v1/{+parent}/reports"
tags: ["organizations"]
---

# POST /v1/{+parent}/reports

`POST /v1/{+parent}/reports`

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.

## Path parameters

- `parent` string, required

## Request body

- GoogleCloudApigeeV1CustomReport
  - `dimensions` string[] — This contains the list of dimensions for the report
  - `chartType` string — This field contains the chart type for the report
  - `sortByCols` string[] — Legacy field: not used much. Contains the list of sort by columns
  - `comments` string[] — Legacy field: not used. This field contains a list of comments associated with custom report
  - `metrics` GoogleCloudApigeeV1CustomReportMetric[] — Required. This contains the list of metrics
    - `name` string — name of the metric
    - `function` string — aggregate function
  - `tags` string[] — Legacy field: not used. This field contains a list of tags associated with custom report
  - `properties` GoogleCloudApigeeV1ReportProperty[] — This field contains report properties such as ui metadata etc.
    - `property` string — name of the property
    - `value` GoogleCloudApigeeV1Attribute[] — property values
      - `name` string — API key of the attribute.
      - `value` string — Value of the attribute.
  - `createdAt` string, int64 — Output only. Unix time when the app was created json key: createdAt
  - `lastModifiedAt` string, int64 — Output only. Modified time of this entity as milliseconds since epoch. json key: lastModifiedAt
  - `name` string — Required. Unique identifier for the report T his is a legacy field used to encode custom report unique id
  - `organization` string — Output only. Organization name
  - `fromTime` string — Legacy field: not used. Contains the from time for the report
  - `environment` string — Output only. Environment name
  - `offset` string — Legacy field: not used. This field contains the offset for the data
  - `toTime` string — Legacy field: not used. Contains the end time for the report
  - `limit` string — Legacy field: not used This field contains the limit for the result retrieved
  - `timeUnit` string — This field contains the time unit of aggregation for the report
  - `displayName` string — This is the display name for the report
  - `lastViewedAt` string, int64 — Output only. Last viewed time of this entity as milliseconds since epoch
  - `sortOrder` string — Legacy field: not used much. Contains the sort order for the sort columns
  - `filter` string — This field contains the filter expression
  - `topk` string — Legacy field: not used. This field contains the top k parameter value for restricting the result

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/apigee.md) · [All operations](https://skmtc.net/google/apis/apigee/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/apigee/versions/6e272fa448a7/schema)