---
title: "Create a dashboard"
method: POST
path: "/v2/dashboards"
tags: ["Dashboards"]
---

# Create a dashboard

`POST /v2/dashboards`

## Request

- Base URL: `https://api.arize.com`
- URL: `https://api.arize.com/v2/dashboards`
- Auth: HTTP bearer

Create an empty dashboard in a space. The caller must have permission to
create dashboards in the target space. New dashboards start active, and
widgets are added separately.

<Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note>

## Request body

- CreateDashboardRequest
  - `space_id` string, required: The ID of the space to create the dashboard in.
  - `name` string, required: The dashboard name. Leading and trailing whitespace is trimmed, and the trimmed name must be 1-255 characters.
  - `timezone` string, nullable: The timezone used to display dashboard data.
  - `start_time` string, date-time, nullable: The start time for the dashboard's default time range, as an RFC 3339 timestamp. Required when `time_range_key` is `custom`.
  - `end_time` string, date-time, nullable: The end time for the dashboard's default time range, as an RFC 3339 timestamp. Required when `time_range_key` is `custom`, and must not be earlier than `start_time`.
  - `time_series_data_granularity` string: The dashboard's time series data granularity, such as `hour` or `day`.
  - `time_range_key` string: The dashboard's default time range. One of `15m`, `1h`, `12h`, `1d`, `7d`, `14d`, `1mo`, `3mo`, `6mo`, or `custom`.

## Response `201`

Dashboard created

- Dashboard: A dashboard groups charts, statistics, text, and tables to help you monitor and analyze your application data. The response includes published widgets only.
  - `id` string, required: The dashboard ID.
  - `space_id` string, required: The space ID the dashboard belongs to.
  - `name` string, required: The dashboard name.
  - `status` 'ACTIVE' | 'INACTIVE' | 'DELETED', required: The dashboard status. Values are `ACTIVE`, `INACTIVE`, or `DELETED`.
  - `timezone` string, nullable: Saved timezone for the dashboard; null means clients use the viewer's local timezone.
  - `start_time` string, date-time, nullable: The dashboard start time.
  - `end_time` string, date-time, nullable: The dashboard end time.
  - `time_series_data_granularity` string: The dashboard's time series data granularity, such as `hour` or `day`.
  - `time_range_key` string, required: The dashboard time range key, such as `7d` or `custom`.
  - `created_at` string, date-time, required: When the dashboard was created.
  - `creator_user_id` string, required: The ID of the user who created the dashboard.
  - `tags` DashboardTagSummary[], required: Tags applied to the dashboard.
    - `id` string, required: The tag ID.
    - `name` string, required: The tag name.
  - `widgets` WidgetSummary[], required: Summaries of the published widgets on the dashboard. Full widget configuration is available from `GET /v2/dashboards/{dashboard_id}/widgets/{widget_id}` (get_dashboard_widget).
    - `id` string, required: A universally unique identifier (base64-encoded opaque string).
    - `title` string, required: Display title of the widget.
    - `type` 'LINE_CHART' | 'BAR_CHART' | 'STATISTIC' | 'TEXT' | 'PIVOT_TABLE' | 'EXPERIMENT_CHART', required: The kind of dashboard widget and the configuration shape it uses.
    - `grid_position` integer[], required: Widget position and size as [x, y, width, height].

## Other responses

- `400`: Invalid request
- `401`: Authentication is required
- `403`: Insufficient permissions to access this resource
- `404`: Not found
- `422`: Unprocessable entity
- `429`: Rate limit exceeded

## Changes

> 48 revisions in range; 1 not diffed.

- **2026-10-28** `22ad4acd3cbb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/arize-ai/apis/arize-rest-api/changes/v2/dashboards/post.md)

---

[API](https://skmtc.dev/arize-ai/apis/arize-rest-api.md) - [All operations](https://skmtc.dev/arize-ai/apis/arize-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arize-ai/apis/arize-rest-api/revisions/22ad4acd3cbb?raw)