---
title: "Return all available metrics across traces and datasets."
method: POST
path: "/tracer/dashboard/metrics/"
tags: ["tracer"]
---

# Return all available metrics across traces and datasets.

`POST /tracer/dashboard/metrics/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/tracer/dashboard/metrics/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Backward compat: if ``workflow`` param is provided, return only
that source's metrics in the old grouped format.

## Request body

- DashboardMetricsCatalogQuery
  - `workflow` 'observability' | 'dataset' | 'simulation'
  - `project_ids` string
  - `agent_definition_id` string, uuid
  - `per_eval_config` boolean
  - `exclude_custom_attributes` boolean
  - `search` string
  - `category` 'system_metric' | 'eval_metric' | 'annotation_metric' | 'custom_attribute' | 'custom_column'
  - `role` 'metric' | 'dimension'
  - `source` 'traces' | 'spans' | 'sessions' | 'users' | 'voice_calls' | 'prompts' | 'datasets' | 'simulation' | 'both' | 'all'
  - `page` integer
  - `page_size` integer
  - `cursor_mode` boolean
  - `cursor` string

## Response `200`

OK

- DashboardMetricsCatalogResponse
  - `status` boolean
  - `result` DashboardMetricsCatalogResult, required
    - `metrics` DashboardMetricCatalogItem[], required
      - `name` string, required
      - `property_id` string, required
      - `property_kind` 'system_attribute' | 'custom_attribute' | 'eval_config' | 'eval_template' | 'annotation' | 'dataset_column', required
      - `display_name` string
      - `category` string
      - `source` string
      - `sources` string[]
      - `type` string
      - `unit` string
      - `output_type` string
      - `eval_template_id` string, uuid
      - `role` 'metric' | 'dimension'
      - `choices` object[]
      - `choice_options` object[]
      - `allowed_aggregations` string[]
      - `data_type` string
      - `attribute_types` string[]
      - `attribute_types_exact` boolean
    - `total` integer, nullable
    - `total_is_exact` boolean
    - `category_counts` object
    - `category_counts_exact` boolean
    - `page` integer
    - `page_size` integer
    - `has_more` boolean
    - `next_cursor` string, nullable
    - `catalog_epoch` integer
    - `catalog_revision` integer
    - `activation_fingerprint` string
    - `query_complete` boolean: Whether this page read completed, not whether all source history is indexed.
    - `query_exact` boolean
    - `query_status` 'complete' | 'partial'
    - `query_provenance` 'activated_property_catalog' | 'current_property_catalog'

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)