---
title: "Related Assets to a Metric"
method: GET
path: "/api/v2/metrics/{metric_name}/assets"
tags: ["Metrics"]
---

# Related Assets to a Metric

`GET /api/v2/metrics/{metric_name}/assets`

Returns dashboards, monitors, notebooks, and SLOs that a metric is stored in, if any.  Updated every 24 hours.

## Path parameters

- `metric_name` string, required

## Response `200`

Success

- MetricAssetsResponse — Response object that includes related dashboards, monitors, notebooks, and SLOs.
  - `data` MetricAssetResponseData — Metric assets response data.
    - `id` string, required — The metric name for this resource.
    - `relationships` MetricAssetResponseRelationships — Relationships to assets related to the metric.
      - `dashboards` MetricAssetDashboardRelationships — An object containing the list of dashboards that can be referenced in the `included` data.
        - `data` MetricAssetDashboardRelationship[] — A list of dashboards that can be referenced in the `included` data.
          - `id` string — The related dashboard's ID.
          - `type` 'dashboards' — Dashboard resource type.
      - `monitors` MetricAssetMonitorRelationships — A object containing the list of monitors that can be referenced in the `included` data.
        - `data` MetricAssetMonitorRelationship[] — A list of monitors that can be referenced in the `included` data.
          - `id` string — The related monitor's ID.
          - `type` 'monitors' — Monitor resource type.
      - `notebooks` MetricAssetNotebookRelationships — An object containing the list of notebooks that can be referenced in the `included` data.
        - `data` MetricAssetNotebookRelationship[] — A list of notebooks that can be referenced in the `included` data.
          - `id` string — The related notebook's ID.
          - `type` 'notebooks' — Notebook resource type.
      - `slos` MetricAssetSLORelationships — An object containing a list of SLOs that can be referenced in the `included` data.
        - `data` MetricAssetSLORelationship[] — A list of SLOs that can be referenced in the `included` data.
          - `id` string — The SLO ID.
          - `type` 'slos' — SLO resource type.
    - `type` 'metrics', required — The metric resource type.
  - `included` MetricAssetResponseIncluded[] — Array of objects related to the metric assets.
    - union — List of included assets with full set of attributes.
      - MetricDashboardAsset — A dashboard object with title and popularity.
        - `attributes` MetricDashboardAttributes — Attributes related to the dashboard, including title, popularity, and url.
          - `popularity` number, double — Value from 0 to 5 that ranks popularity of the dashboard.
          - `tags` string[] — List of tag keys used in the asset.
          - `title` string — Title of the asset.
          - `url` string — URL path of the asset.
        - `id` string, required — The related dashboard's ID.
        - `type` 'dashboards', required — Dashboard resource type.
      - MetricMonitorAsset — A monitor object with title.
        - `attributes` MetricAssetAttributes — Assets related to the object, including title, url, and tags.
          - `tags` string[] — List of tag keys used in the asset.
          - `title` string — Title of the asset.
          - `url` string — URL path of the asset.
        - `id` string, required — The related monitor's ID.
        - `type` 'monitors', required — Monitor resource type.
      - MetricNotebookAsset — A notebook object with title.
        - `attributes` MetricAssetAttributes — Assets related to the object, including title, url, and tags.
          - `tags` string[] — List of tag keys used in the asset.
          - `title` string — Title of the asset.
          - `url` string — URL path of the asset.
        - `id` string, required — The related notebook's ID.
        - `type` 'notebooks', required — Notebook resource type.
      - MetricSLOAsset — A SLO object with title.
        - `attributes` MetricAssetAttributes — Assets related to the object, including title, url, and tags.
          - `tags` string[] — List of tag keys used in the asset.
          - `title` string — Title of the asset.
          - `url` string — URL path of the asset.
        - `id` string, required — The SLO ID.
        - `type` 'slos', required — SLO resource type.

## Other responses

- `400` — API error response.
- `403` — API error response.
- `404` — API error response.
- `429` — Too Many Requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)
