> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# roark dashboard create

> Create a dashboard

Creates a dashboard with its widgets. Each widget is an analytics query (see POST /v1/analytics/query) with a name unique on the dashboard, a `display` (LINE, NUMBER, RADAR, `STACKED_BAR`, TABLE) and a `size` (SMALL, MEDIUM, LARGE, `EXTRA_LARGE`). Widgets render top to bottom in the order given. Dashboard `filters` apply over every widget and must be conversation-level: `AGENT_PROPERTY`, `CALL_PROPERTY`, MODALITY, DATASET or `METRIC_VALUE`. On a field a widget already filters, the dashboard's wins.

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark dashboard create [options]
```

> [!NOTE]
>
> Calls `POST /v1/dashboard`

## Options

**--name** `string` *required*

**--description** `string`

**--time-range** `string`

The window: LAST n DAYS/WEEKS/MONTHS up to now, a `CALENDAR_ALIGNED` period (TODAY, YESTERDAY, `THIS_WEEK`, `LAST_WEEK`, `THIS_MONTH`, `LAST_MONTH`, `THIS_YEAR`, `LAST_YEAR`), FIXED from/to, or SINCE a date. At most 731 days (two years).

**--filters** `array`

**--is-default** `switch`

**--widgets** `array`

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark dashboard create --name <value>
```

Every command also takes the [global options](/cli-reference/overview.md#global-options) and sets one
of the [exit codes](/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.