---
title: "List metric definitions"
method: GET
path: "/api/metrics/definitions"
tags: ["Metrics"]
---

# List metric definitions

`GET /api/metrics/definitions`

## Query parameters

- `agentId` string
- `limit` integer
- `offset` integer, nullable
- `fields` 'full' | 'slim'

## Response `200`

Metric definitions

- object
  - `metrics` union[], required
    - union
      - Metric
        - `id` string, required
        - `agentId` string, required
        - `slug` string, required
        - `title` string, required
        - `description` string
        - `definition` MetricDefinition, required
          - `version` 1, required
          - `widgets` MetricWidget[], required
            - `id` string, required
            - `title` string, required
            - `description` string
            - `query` object, required
              - …
            - `viz` MetricVizConfig, required
              - …
            - `colSpan` integer
            - `rowSpan` integer
          - `variables` MetricVariable[]
            - `key` string, required
            - `label` string
            - `type` 'text' | 'number' | 'select'
            - `defaultValue` union
              - …
            - `options` object[]
              - …
            - `optionsQuery` object
              - …
          - `layout` object
            - `columns` integer
          - `refreshSeconds` integer
        - `createdAt` string, required
        - `updatedAt` string, required
      - object
        - `id` string, required
        - `agentId` string, required
        - `slug` string, required
        - `title` string, required
        - `description` string
        - `createdAt` string, required
        - `updatedAt` string, required
  - `total` number, required
  - `limit` number, required
  - `offset` number, required

## Changes

- **2026-08-07** `06cac6a7c5bc` — 1 info
  - added the media type `application/json` for the response with the status `200`
- **2026-07-06** `2c8021c48f65` — 1 info
  - endpoint added
- **2026-07-02** `0c910612f9ac` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/metrics/definitions/get.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/desplega-ai/agent-swarm-api/revisions/e0acd2155cad/schema)