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

# POST /v1/{+parent}/dashboards

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

Creates a Dashboard.

## Path parameters

- `parent` string, required

## Query parameters

- `dashboardId` string

## Request body

- GoogleCloudContactcenterinsightsV1Dashboard — Configurable dashboard
  - `filter` string — Filter applied to all charts in the dashboard. Should support scope later.
  - `dateRangeConfig` GoogleCloudContactcenterinsightsV1DateRangeConfig — Date range configuration for dashboard charts.
    - `relativeDateRange` GoogleCloudContactcenterinsightsV1DateRangeConfigRelativeDateRange — Relative date range configuration.
      - `quantity` string, int64 — Required. The quantity of units in the past.
      - `unit` 'TIME_UNIT_UNSPECIFIED' | 'DAY' | 'WEEK' | 'MONTH' | 'QUARTER' | 'YEAR' — Required. The unit of time.
    - `absoluteDateRange` GoogleCloudContactcenterinsightsV1QueryInterval — A time window for querying conversations.
      - `startTime` string, google-datetime — Required. The start time of the time window.
      - `endTime` string, google-datetime — Required. The end time of the time window.
  - `readOnly` boolean — Output only. Whether the dashboard is read-only. All predefined dashboards are read-only and cannot be modified by the user.
  - `description` string — Dashboard description
  - `rootContainer` GoogleCloudContactcenterinsightsV1Container — Configurable dashboard's container. Container can contain multiple widgets.
    - `width` integer — The width of the container in grid units.
    - `containerId` string — Output only. Unique ID for the container.
    - `height` integer — The height of the container in grid units.
    - `widgets` GoogleCloudContactcenterinsightsV1Widget[] — Widgets in the Container.
      - `container` GoogleCloudContactcenterinsightsV1Container — recursive
      - `chartReference` string — A reference to a chart widget. Format: projects/{project}/locations/{location}/dashboards/{dashboard}/charts/{chart}
      - `chart` GoogleCloudContactcenterinsightsV1Chart — Configurable dashboard's widget that displays data as a chart.
        - `chartType` 'CHART_TYPE_UNSPECIFIED' | 'SYSTEM_DEFINED' | 'USER_DEFINED' — Output only. Chart type.
        - `action` GoogleCloudContactcenterinsightsV1ChartAction — The action to be taken when the chart is clicked.
          - `redirectAction` GoogleCloudContactcenterinsightsV1RedirectAction — The redirect action to be taken when the chart is clicked.
            - `relativePath` string — The relative path to redirect to.
            - `queryParams` object — The query params to be added to the redirect path.
          - `conversationFilter` string — The conversation filter string.
        - `description` string — Chart description
        - `filter` string — Filter applied to all charts in the container. Should support scope later.
        - `dateRangeConfig` GoogleCloudContactcenterinsightsV1DateRangeConfig — Date range configuration for dashboard charts.
          - `relativeDateRange` GoogleCloudContactcenterinsightsV1DateRangeConfigRelativeDateRange — Relative date range configuration.
            - `quantity` string, int64 — Required. The quantity of units in the past.
            - `unit` 'TIME_UNIT_UNSPECIFIED' | 'DAY' | 'WEEK' | 'MONTH' | 'QUARTER' | 'YEAR' — Required. The unit of time.
          - `absoluteDateRange` GoogleCloudContactcenterinsightsV1QueryInterval — A time window for querying conversations.
            - `startTime` string, google-datetime — Required. The start time of the time window.
            - `endTime` string, google-datetime — Required. The end time of the time window.
        - `chartVisualizationType` 'CHART_VISUALIZATION_TYPE_UNSPECIFIED' | 'BAR' | 'LINE' | 'AREA' | 'PIE' | 'SCATTER' | 'TABLE' | 'SCORE_CARD' | 'SUNBURST' | 'GAUGE' | 'SANKEY' — Chart visualization type.
        - `createTime` string, google-datetime — Output only. Chart create time.
        - `updateTime` string, google-datetime — Output only. Chart last update time.
        - `dataSource` GoogleCloudContactcenterinsightsV1ChartDataSource — The request data for visualizing the dataset in the chart.
          - `generativeInsights` GoogleCloudContactcenterinsightsV1GenerativeInsights — Request that use natural language query to generate the chart.
            - `chartSpec` object — Chart spec for the chart.
            - `chartConversations` GoogleCloudContactcenterinsightsV1GenerativeInsightsChartConversation[] — Output only. The chart conversations used to generate the chart.
              - …
            - `chartCheckpoint` GoogleCloudContactcenterinsightsV1GenerativeInsightsChartCheckpoint — The current chart checkpoint state.
              - …
            - `request` object
            - `sqlQuery` string — SQL query used to generate the chart.
            - `sqlComparisonKey` string — Optional. For charts with comparison, this key will determine the metric that will be compared between the current and another dataset.
          - `queryMetrics` GoogleCloudContactcenterinsightsV1QueryMetrics — Request data that use the existing QueryMetrics.
            - `request` object
        - `displayName` string — User provided display name of the chart.
        - `name` string — Identifier. Chart resource name. Format: projects/{project}/locations/{location}/dashboards/{dashboard}/charts/{chart}
        - `height` integer — The height of the chart in grid units.
        - `width` integer — The width of the chart in grid units.
      - `filter` string — Filter applied to all charts in the container. Should support scope later.
    - `description` string — Container description
    - `filter` string — Filter applied to all charts in the container. Should support scope later.
    - `displayName` string — User provided display name of the Container.
    - `dateRangeConfig` GoogleCloudContactcenterinsightsV1DateRangeConfig — Date range configuration for dashboard charts.
      - `relativeDateRange` GoogleCloudContactcenterinsightsV1DateRangeConfigRelativeDateRange — Relative date range configuration.
        - `quantity` string, int64 — Required. The quantity of units in the past.
        - `unit` 'TIME_UNIT_UNSPECIFIED' | 'DAY' | 'WEEK' | 'MONTH' | 'QUARTER' | 'YEAR' — Required. The unit of time.
      - `absoluteDateRange` GoogleCloudContactcenterinsightsV1QueryInterval — A time window for querying conversations.
        - `startTime` string, google-datetime — Required. The start time of the time window.
        - `endTime` string, google-datetime — Required. The end time of the time window.
  - `updateTime` string, google-datetime — Output only. Dashboard last update time.
  - `createTime` string, google-datetime — Output only. Dashboard creation time.
  - `displayName` string — User provided display name of the dashboard.
  - `name` string — Identifier. Dashboard resource name. Format: projects/{project}/locations/{location}/dashboards/{dashboard}

## Response `200`

Successful response

---

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