Skip to main content
GET
Get a dashboard widget

Authorizations

Authorization
string
header
required

Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format

Path Parameters

dashboard_id
string
required

The Relay global ID of the dashboard. A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

widget_id
string
required

The Relay global ID of the widget. A universally unique identifier (base64-encoded opaque string).

Example:

"RW50aXR5OjEyMzQ1"

Response

Returns one dashboard widget with its type-specific configuration.

A dashboard widget and its type-specific saved configuration.

id
string
required

Unique identifier for the widget.

Example:

"RW50aXR5OjEyMzQ1"

type
enum<string>
required

Identifies this widget as a line chart.

Available options:
LINE_CHART
dashboard_id
string
required

Unique identifier for the dashboard containing the widget.

Example:

"RW50aXR5OjEyMzQ1"

title
string
required

Display title of the widget.

grid_position
integer[]
required

Position and size of the widget in the dashboard grid.

Required array length: 4 elements
Required range: x >= 0
creation_status
enum<string>
required

Publication state of the widget.

Available options:
DRAFT,
PUBLISHED
created_at
string<date-time>
required

Timestamp when the widget was created.

creator_user_id
string
required

Unique identifier for the user who created the widget.

Example:

"RW50aXR5OjEyMzQ1"

widget_type
enum<string>
required

Visualization mode used by the chart.

Available options:
LINE,
DRIFT,
MONITOR,
SCATTER
plots
object[]
required

Metric series displayed by the widget.

time_series_metric_type
string
required

Metric used to compute the time series.

monitor_id
string

Monitor represented by the widget when using the monitor chart mode.

Example:

"RW50aXR5OjEyMzQ1"

y_min
number | null

Minimum value displayed on the y-axis, or null for automatic scaling.

y_max
number | null

Maximum value displayed on the y-axis, or null for automatic scaling.

y_axis_label
string | null

Custom y-axis label, or null to use the default.

x_axis_label
string | null

Custom x-axis label, or null to use the default.

x_axis_tilt
string | null

Saved rotation setting for x-axis labels.

font_size
string | null

Saved chart font-size setting.

show_legend
boolean | null

Whether the legend is shown, or null to use the default.

legend_placement
string | null

Saved placement of the chart legend.

timezone
string | null

Timezone used to display time-series values.

start_time
string<date-time> | null

Widget-specific range start, or null when the dashboard range applies.

end_time
string<date-time> | null

Widget-specific range end, or null when the dashboard range applies.

time_series_data_granularity
string | null

Saved aggregation interval for the time series.

overwrite_global_time
boolean | null

Whether this widget uses its own time range instead of the dashboard range.

time_range_key
string | null

Saved relative time-range selection.