← All resources

Resource

dashboard_card

A card within a dashboard — one metric, chart, table, block of markdown, or embedded custom app. Cards display; they take no actions.

GraphQL reference →

Configuration

dashboardIdDashboardID!RequiredSet on creation

Dashboard this card belongs to

References dashboard

set once, at creation

titleString!Required

Card title

cardTypeDashboardCardType!Required

What the card renders

Allowed values

CUSTOM_APP — Embeds a custom app

RESOURCE_TABLE — Displays a lightweight table of recent records

MARKDOWN — Displays rich text / markdown content

METRIC — Displays a single metric value with optional query

METRIC_CHART — Time-bucketed line/bar chart powered by aggregateMetricPoints

METRIC_HISTOGRAM — Value distribution histogram powered by metricHistogram

METRIC_GAUGE — Current value gauge with trend projection powered by metricProjection

METRIC_COMPARISON — Multi-metric overlay chart powered by compareMetrics

configJSON!Required

Card configuration, shaped by cardType

positionDashboardCardPosition!Optional

Grid position and size

View DashboardCardPositionInput fields →

sortOrderInt!Optional

Ordering within the dashboard (defaults to 0)

Input types

Fields for the structured values used in this resource’s configuration.

DashboardCardPositionInput

Grid position input for a dashboard card

xInt!Required

Grid column position

yInt!Required

Grid row position

wInt!Required

Width in grid columns

hInt!Required

Height in grid rows

Read-only values

Show values
idDashboardCardID!Read only

Unique identifier

computed by the platform

createdAtString!Read only

Creation timestamp (ISO8601)

computed by the platform

updatedAtString!Read only

Last update timestamp (ISO8601)

computed by the platform

Lifecycle

The CLI can create this resource. The platform assigns its id.

When replacement is needed, the existing resource is removed before its replacement is created.