# NewDashboardInput

input type

The tenant stamps server-side; widgets 1..16, ordinals unique, every metricKey ∈ the canned roster.

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `caption` | [String](/types/#scalars) | no | Optional: when omitted the per-type default applies — the widget count (e.g. `dashboard ×4`); when supplied it must be non-blank. |
| `widgets` | [DashboardWidgetInput](/types/DashboardWidgetInput/) `[DashboardWidgetInput!]!` | yes | The initial layout (1..16; ordinals unique). |

## Used by

- [createDashboard](/reference/dashboard/createDashboard/)