---
title: "List monitor presets"
method: GET
path: "/v2/monitors/presets"
tags: ["Monitors"]
---

# List monitor presets

`GET /v2/monitors/presets`

## Request

- Base URL: `https://my.orq.ai`
- URL: `https://my.orq.ai/v2/monitors/presets`
- Auth: HTTP bearer

Returns the built-in monitor templates (preset dashboards and preset widgets). Presets are defined by the platform and versioned with it; create a monitor from a preset by copying its widgets into a create request and stamping `preset_key`.

## Response `200`

OK

- ListMonitorPresetsResponse
  - `object` string, required: Object discriminator for list responses; always `list`.
  - `data` MonitorPreset[], required: Built-in presets, dashboards first.
    - `preset_key` string, required: Stable identifier for the preset, e.g. `genai-overview` or `widget-cost-by-model`.
    - `display_name` string, required: Human-readable preset name shown in galleries.
    - `description` string, required: What the preset shows and when to use it.
    - `kind` 'dashboard' | 'widget', required: Preset kind.
    - `widgets` MonitorWidget[], required: Widgets the preset materializes into a create request. Widget presets carry exactly one entry.
      - `widget_id` string, required: Widget identifier, unique within the monitor. Provide your own or leave empty to have the server assign one.
      - `type` 'timeseries' | 'toplist' | 'table' | 'bignumber' | 'donut' | 'breakdown', required: Widget rendering type.
      - `title` string, required: Title shown in the widget header.
      - `queries` MonitorWidgetQuery[], required: The one query feeding the widget. It maps onto QueryTelemetry; the viewer's time range, time zone, and the query mode derived from the widget type are supplied at render time.
        - `source` 'MONITOR_TELEMETRY_SOURCE_TRACES' | 'MONITOR_TELEMETRY_SOURCE_METRICS' | 'MONITOR_TELEMETRY_SOURCE_LOGS'
        - `metric` string, required: Source-owned metric identifier. Static `genai.*` trace metrics are validated when saved; runtime metrics, logs, and raw trace aggregates are validated by the caller-scoped telemetry capability/query service.
        - `operation` string: Source-owned aggregation operation advertised by telemetry capabilities.
        - `group_by` string[]: Reporting dimensions to break down by. Valid dimensions depend on the metric; validated when the monitor is saved.
        - `filters` MonitorFilter[]: Reporting filters combined with AND.
          - `field` string, required: Reporting dimension to filter on. Valid fields depend on the metric; validated when the monitor is saved.
          - `op` 'eq' | 'neq' | 'in' | 'not_in' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'contains' | 'exists' | 'not_exists', required: Predicate operator. `eq` and `neq` accept exactly one value; `in` and `not_in` accept 1-100 values.
          - `values` string[], required: Values compared against the selected field.
        - `grain` 'auto' | 'minute' | 'hour' | 'day': Requested bucket grain for timeseries widgets.
        - `limit` integer: Row cap. Zero uses the reporting default. For toplist widgets this is the top-N group count.
        - `additional_computes` MonitorWidgetCompute[]: Extra computes for breakdown widgets, rendered as columns after the primary `metric`/`operation`, which drives sorting. They share the query's source, grouping, and filters.
          - `metric` string, required: Source-owned metric identifier.
          - `operation` string, required: Source-owned aggregation operation advertised by telemetry capabilities.
      - `display` MonitorWidgetDisplay
        - `visualization` 'lines' | 'bars' | 'area': Chart style for timeseries widgets.
        - `unit` 'count' | 'cost' | 'duration' | 'percent' | 'bytes': Unit used for axis and value formatting.
        - `sort` 'desc' | 'asc': Value ordering for toplist, table and breakdown widgets.
        - `show_overall` boolean: When true, toplist, table and breakdown widgets also show the overall total across all groups for the window.
        - `target` number, double: Optional threshold line rendered on timeseries widgets.
        - `decimals` integer: Decimal places used when formatting values.
        - `show_others` boolean: When true, toplist and donut widgets show the combined value of groups outside the configured limit.
        - `show_percentages` boolean: When true, toplist and donut widget values are shown as a percentage of the overall total.
      - `layout` MonitorWidgetLayout, required
        - `x` integer, required: Column offset in grid units.
        - `y` integer, required: Row offset in grid units.
        - `w` integer, required: Width in grid units.
        - `h` integer, required: Height in grid units.
    - `default_range` '5m' | '15m' | '30m' | '1h' | '6h' | '12h' | '1d' | '7d' | '14d' | '30d' | '60d' | '90d': Default relative time range suggested by the preset.

## Other responses

- `401`: Authentication required. See https://docs.orq.ai/reference/errors for the error codes.

## Changes

> 554 revisions in range; 71 not diffed.

- **2026-10-23** `0b4e519a544f`: 1 info
  - endpoint added
- **2026-10-23** `732aed62833a`: 1 breaking
  - api path removed without deprecation
- **2026-10-22** `4f826b2c3a0e`: 1 info
  - endpoint added
- **2026-10-22** `8f0dc569f247`: 1 breaking
  - api path removed without deprecation
- **2026-10-21** `08b800d640e6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/monitors/presets/get.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) - [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orq-ai/apis/orq-ai-api/revisions/928a71e92252?raw)