---
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`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/metrics/{metric_name}/assets`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token`

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.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)