---
title: "Update metric"
method: PATCH
path: "/api/v2/experiments/metrics/{metric_id}"
tags: ["Experiments"]
---

# Update metric

`PATCH /api/v2/experiments/metrics/{metric_id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/experiments/metrics/{metric_id}`
- 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` scopes: `product_analytics_metrics_write`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/experiments/metrics/:metric_id/patch.ts> (a function with typed inputs; its response is checked against the schema)

Update a metric. Certified metrics are read-only through this endpoint. This is a partial update: every attribute is optional and an omitted attribute keeps its stored value, so a body carrying only the fields being changed is enough. `guardrail_cutoff_threshold` is nullable -- send null to clear it, omit it to leave it alone. Omitting the aggregation leaves the metric's definition untouched; supplying one replaces it wholesale, and the metric's type is re-derived from the shape supplied. Property filters use property_id or measure_id UUIDs from the aggregation's data source. Attributes that are computed rather than stored (short_id, metric_type, certified_at, experiment_count, created_at, updated_at) are rejected rather than ignored, so a body copied from GET must have them removed. The is_certified attribute is rejected. Certification cannot be changed through this endpoint.

## Path parameters

- `metric_id` string, uuid, required: The UUID of the metric.

## Request body

- ExperimentsUpdateMetricV2Request: Request to update the metric.
  - `data` ExperimentsUpdateMetricV2RequestData, required: JSON:API resource containing the metric identity and fields.
    - `attributes` ExperimentsUpdateMetricV2RequestDataAttributes: Fields supplied to update the metric. Every attribute is optional; omit an attribute to leave it unchanged.
      - `data_source_type` 'DATADOG' | 'DATADOG_REFERENCE_TABLE' | 'CUSTOMER_WAREHOUSE': Source of the data backing this metric.
      - `denominator_aggregation` union: Measure and calculation settings for a numerator or denominator aggregation. Supply exactly one non-null measure.
        - ExperimentsWarehouseMetricAggregationInput: Settings for a metric aggregation that uses a Warehouse measure. The other measure must be omitted or null.
          - `aging_threshold_days` integer: Stored aging threshold in days. The subject aging filter uses the aggregation window end and unit.
          - `datadog_metric_measure` ExperimentsNullableDatadogMetricMeasureInput, nullable: Optional Datadog measure. Use null when the other measure is selected.
            - `column_name` string: Name of the Datadog event field used by this measure.
            - `column_type` string, required: Data type of the source column.
            - `filters` unknown
            - `name` string, required: Display name of the Datadog measure.
            - `query` string: Query used to retrieve the Datadog measure.
            - `source_definition_filter` unknown
            - `source_subtype` string, required: Subtype of the Datadog data source.
            - `source_type` string, required: Type of Datadog data source used for the measure.
          - `enable_aging_subject_filter` boolean: Whether to exclude subjects whose observation time is shorter than the aggregation window.
          - `operation` string, required: Calculation applied to the measure values, such as sum.
          - `property_filters` ExperimentsWarehouseFilterInputGroup[], nullable: Property filters that select data for this aggregation.
            - ExperimentsWarehouseFilterInput[]: Metric filters combined with AND. Each group must contain at least one filter.
              - …
          - `threshold_aggregation_type` string: Calculation used to evaluate the threshold.
          - `threshold_breach_value` number, double: Value used to determine whether the threshold is breached.
          - `threshold_comparison_operator` string: Operator used to compare the calculated value with the threshold.
          - `threshold_timeframe_dimension` string: Time unit for the threshold evaluation window. Supports seconds, minutes, hours, days, calendar_days, and weeks. Calendar days start at midnight on the assignment day. Other units start at the assignment time.
          - `threshold_timeframe_value` number, double: End of the threshold evaluation window, measured from assignment in the configured time unit.
          - `timeframe_end_value` number, double: End offset of the aggregation window from assignment, in timeframe_unit.
          - `timeframe_start_value` number, double: Start offset of the aggregation window from assignment, in timeframe_unit.
          - `timeframe_unit` string: Time unit for the aggregation window. Calendar days are measured from midnight on the assignment day. Other units are measured from the assignment time.
          - `warehouse_metric_measure` ExperimentsWarehouseMetricMeasure, required: Reference to a measure defined in a warehouse metric SQL model.
            - `id` string, uuid, required: Identifier of the warehouse metric measure.
          - `winsor_lower_fixed_value` number, double: Fixed lower bound used to cap extreme measure values.
          - `winsor_lower_percentile` number, double: Percentile used to determine the lower bound for extreme measure values.
          - `winsor_upper_fixed_value` number, double: Fixed upper bound used to cap extreme measure values.
          - `winsor_upper_percentile` number, double: Percentile used to determine the upper bound for extreme measure values.
          - `winsorization_strategy` string: Method used to cap extreme measure values before aggregation.
        - ExperimentsDatadogMetricAggregationInput: Settings for a metric aggregation that uses a Datadog measure. The other measure must be omitted or null.
          - `aging_threshold_days` integer: Stored aging threshold in days. The subject aging filter uses the aggregation window end and unit.
          - `datadog_metric_measure` ExperimentsDatadogMetricMeasureInput, required: Datadog source and query that supply values for the metric.
            - `column_name` string: Name of the Datadog event field used by this measure.
            - `column_type` string, required: Data type of the source column.
            - `filters` unknown
            - `name` string, required: Display name of the Datadog measure.
            - `query` string: Query used to retrieve the Datadog measure.
            - `source_definition_filter` unknown
            - `source_subtype` string, required: Subtype of the Datadog data source.
            - `source_type` string, required: Type of Datadog data source used for the measure.
          - `enable_aging_subject_filter` boolean: Whether to exclude subjects whose observation time is shorter than the aggregation window.
          - `operation` string, required: Calculation applied to the measure values, such as sum.
          - `property_filters` ExperimentsPropertyFilterInputGroup[], nullable: Property filters that select data for this aggregation.
            - ExperimentsPropertyFilterInput[]: Metric filters combined with AND. Each group must contain at least one filter.
              - …
          - `threshold_aggregation_type` string: Calculation used to evaluate the threshold.
          - `threshold_breach_value` number, double: Value used to determine whether the threshold is breached.
          - `threshold_comparison_operator` string: Operator used to compare the calculated value with the threshold.
          - `threshold_timeframe_dimension` string: Time unit for the threshold evaluation window. Supports seconds, minutes, hours, days, calendar_days, and weeks. Calendar days start at midnight on the assignment day. Other units start at the assignment time.
          - `threshold_timeframe_value` number, double: End of the threshold evaluation window, measured from assignment in the configured time unit.
          - `timeframe_end_value` number, double: End offset of the aggregation window from assignment, in timeframe_unit.
          - `timeframe_start_value` number, double: Start offset of the aggregation window from assignment, in timeframe_unit.
          - `timeframe_unit` string: Time unit for the aggregation window. Calendar days are measured from midnight on the assignment day. Other units are measured from the assignment time.
          - `warehouse_metric_measure` ExperimentsNullableWarehouseMetricMeasureInput, nullable: Optional warehouse measure. Use null when the other measure is selected.
            - `id` string, uuid, required: Identifier of the warehouse metric measure.
          - `winsor_lower_fixed_value` number, double: Fixed lower bound used to cap extreme measure values.
          - `winsor_lower_percentile` number, double: Percentile used to determine the lower bound for extreme measure values.
          - `winsor_upper_fixed_value` number, double: Fixed upper bound used to cap extreme measure values.
          - `winsor_upper_percentile` number, double: Percentile used to determine the upper bound for extreme measure values.
          - `winsorization_strategy` string: Method used to cap extreme measure values before aggregation.
      - `description` string, nullable: Send null to clear the description. Omit to leave it unchanged.
      - `desired_change` 'METRIC_INCREASES' | 'METRIC_DECREASES': Direction of change that represents an improvement for this metric.
      - `format_as_percent` boolean: Whether results render as a percentage. Omit to leave it unchanged.
      - `guardrail_cutoff_threshold` number, double, nullable: Send null to clear a stored threshold. Omit to leave it unchanged.
      - `migration_metadata` unknown
      - `name` string: Name of the metric. Omit to leave it unchanged.
      - `numerator_aggregation` union: Measure and calculation settings for a numerator or denominator aggregation. Supply exactly one non-null measure.
        - ExperimentsWarehouseMetricAggregationInput: Settings for a metric aggregation that uses a Warehouse measure. The other measure must be omitted or null.
          - `aging_threshold_days` integer: Stored aging threshold in days. The subject aging filter uses the aggregation window end and unit.
          - `datadog_metric_measure` ExperimentsNullableDatadogMetricMeasureInput, nullable: Optional Datadog measure. Use null when the other measure is selected.
            - `column_name` string: Name of the Datadog event field used by this measure.
            - `column_type` string, required: Data type of the source column.
            - `filters` unknown
            - `name` string, required: Display name of the Datadog measure.
            - `query` string: Query used to retrieve the Datadog measure.
            - `source_definition_filter` unknown
            - `source_subtype` string, required: Subtype of the Datadog data source.
            - `source_type` string, required: Type of Datadog data source used for the measure.
          - `enable_aging_subject_filter` boolean: Whether to exclude subjects whose observation time is shorter than the aggregation window.
          - `operation` string, required: Calculation applied to the measure values, such as sum.
          - `property_filters` ExperimentsWarehouseFilterInputGroup[], nullable: Property filters that select data for this aggregation.
            - ExperimentsWarehouseFilterInput[]: Metric filters combined with AND. Each group must contain at least one filter.
              - …
          - `threshold_aggregation_type` string: Calculation used to evaluate the threshold.
          - `threshold_breach_value` number, double: Value used to determine whether the threshold is breached.
          - `threshold_comparison_operator` string: Operator used to compare the calculated value with the threshold.
          - `threshold_timeframe_dimension` string: Time unit for the threshold evaluation window. Supports seconds, minutes, hours, days, calendar_days, and weeks. Calendar days start at midnight on the assignment day. Other units start at the assignment time.
          - `threshold_timeframe_value` number, double: End of the threshold evaluation window, measured from assignment in the configured time unit.
          - `timeframe_end_value` number, double: End offset of the aggregation window from assignment, in timeframe_unit.
          - `timeframe_start_value` number, double: Start offset of the aggregation window from assignment, in timeframe_unit.
          - `timeframe_unit` string: Time unit for the aggregation window. Calendar days are measured from midnight on the assignment day. Other units are measured from the assignment time.
          - `warehouse_metric_measure` ExperimentsWarehouseMetricMeasure, required: Reference to a measure defined in a warehouse metric SQL model.
            - `id` string, uuid, required: Identifier of the warehouse metric measure.
          - `winsor_lower_fixed_value` number, double: Fixed lower bound used to cap extreme measure values.
          - `winsor_lower_percentile` number, double: Percentile used to determine the lower bound for extreme measure values.
          - `winsor_upper_fixed_value` number, double: Fixed upper bound used to cap extreme measure values.
          - `winsor_upper_percentile` number, double: Percentile used to determine the upper bound for extreme measure values.
          - `winsorization_strategy` string: Method used to cap extreme measure values before aggregation.
        - ExperimentsDatadogMetricAggregationInput: Settings for a metric aggregation that uses a Datadog measure. The other measure must be omitted or null.
          - `aging_threshold_days` integer: Stored aging threshold in days. The subject aging filter uses the aggregation window end and unit.
          - `datadog_metric_measure` ExperimentsDatadogMetricMeasureInput, required: Datadog source and query that supply values for the metric.
            - `column_name` string: Name of the Datadog event field used by this measure.
            - `column_type` string, required: Data type of the source column.
            - `filters` unknown
            - `name` string, required: Display name of the Datadog measure.
            - `query` string: Query used to retrieve the Datadog measure.
            - `source_definition_filter` unknown
            - `source_subtype` string, required: Subtype of the Datadog data source.
            - `source_type` string, required: Type of Datadog data source used for the measure.
          - `enable_aging_subject_filter` boolean: Whether to exclude subjects whose observation time is shorter than the aggregation window.
          - `operation` string, required: Calculation applied to the measure values, such as sum.
          - `property_filters` ExperimentsPropertyFilterInputGroup[], nullable: Property filters that select data for this aggregation.
            - ExperimentsPropertyFilterInput[]: Metric filters combined with AND. Each group must contain at least one filter.
              - …
          - `threshold_aggregation_type` string: Calculation used to evaluate the threshold.
          - `threshold_breach_value` number, double: Value used to determine whether the threshold is breached.
          - `threshold_comparison_operator` string: Operator used to compare the calculated value with the threshold.
          - `threshold_timeframe_dimension` string: Time unit for the threshold evaluation window. Supports seconds, minutes, hours, days, calendar_days, and weeks. Calendar days start at midnight on the assignment day. Other units start at the assignment time.
          - `threshold_timeframe_value` number, double: End of the threshold evaluation window, measured from assignment in the configured time unit.
          - `timeframe_end_value` number, double: End offset of the aggregation window from assignment, in timeframe_unit.
          - `timeframe_start_value` number, double: Start offset of the aggregation window from assignment, in timeframe_unit.
          - `timeframe_unit` string: Time unit for the aggregation window. Calendar days are measured from midnight on the assignment day. Other units are measured from the assignment time.
          - `warehouse_metric_measure` ExperimentsNullableWarehouseMetricMeasureInput, nullable: Optional warehouse measure. Use null when the other measure is selected.
            - `id` string, uuid, required: Identifier of the warehouse metric measure.
          - `winsor_lower_fixed_value` number, double: Fixed lower bound used to cap extreme measure values.
          - `winsor_lower_percentile` number, double: Percentile used to determine the lower bound for extreme measure values.
          - `winsor_upper_fixed_value` number, double: Fixed upper bound used to cap extreme measure values.
          - `winsor_upper_percentile` number, double: Percentile used to determine the upper bound for extreme measure values.
          - `winsorization_strategy` string: Method used to cap extreme measure values before aggregation.
      - `percentile_aggregation` union: Measure and percentile to calculate for the metric. Supply exactly one non-null measure.
        - ExperimentsWarehousePercentileAggregationInput: Settings for a percentile aggregation that uses a Warehouse measure. The other measure must be omitted or null.
          - `datadog_metric_measure` ExperimentsNullableDatadogPercentileMeasureInput, nullable: Optional Datadog percentile measure. Use null when the warehouse measure is selected.
            - `column_name` string, required: Name of the Datadog event field used by this measure.
            - `column_type` string, required: Data type of the source column.
            - `filters` unknown
            - `name` string, required: Display name of the Datadog measure.
            - `query` string: Query used to retrieve the Datadog measure.
            - `source_definition_filter` unknown
            - `source_subtype` string, required: Subtype of the Datadog data source.
            - `source_type` string, required: Type of Datadog data source used for the measure.
          - `percentile` number, double, required: Percentile to calculate from the measure values.
          - `property_filters` ExperimentsPropertyFilterInputGroup[], nullable: Property filters that select data for the percentile calculation.
            - ExperimentsPropertyFilterInput[]: Metric filters combined with AND. Each group must contain at least one filter.
              - …
          - `warehouse_metric_measure` ExperimentsWarehouseMetricMeasure, required: Reference to a measure defined in a warehouse metric SQL model.
            - `id` string, uuid, required: Identifier of the warehouse metric measure.
        - ExperimentsDatadogPercentileAggregationInput: Settings for a percentile aggregation that uses a Datadog measure. The other measure must be omitted or null.
          - `datadog_metric_measure` ExperimentsDatadogPercentileMeasureInput, required: Datadog measure used to calculate a percentile.
            - `column_name` string, required: Name of the Datadog event field used by this measure.
            - `column_type` string, required: Data type of the source column.
            - `filters` unknown
            - `name` string, required: Display name of the Datadog measure.
            - `query` string: Query used to retrieve the Datadog measure.
            - `source_definition_filter` unknown
            - `source_subtype` string, required: Subtype of the Datadog data source.
            - `source_type` string, required: Type of Datadog data source used for the measure.
          - `percentile` number, double, required: Percentile to calculate from the measure values.
          - `property_filters` ExperimentsPropertyFilterInputGroup[], nullable: Property filters that select data for the percentile calculation.
            - ExperimentsPropertyFilterInput[]: Metric filters combined with AND. Each group must contain at least one filter.
              - …
          - `warehouse_metric_measure` ExperimentsNullableWarehouseMetricMeasureInput, nullable: Optional warehouse measure. Use null when the other measure is selected.
            - `id` string, uuid, required: Identifier of the warehouse metric measure.
    - `id` string, uuid: ID of the metric.
    - `type` 'metrics', required: The metric resource type.

## Response `200`

OK

- ExperimentsMetricV2DTO: Response containing the metric.
  - `data` ExperimentsMetricV2DTOData, required: JSON:API resource containing the metric identity and fields.
    - `attributes` ExperimentsMetricV2DTODataAttributes: Details of the metric.
      - `certified_at` string, date-time, nullable: Time when this resource was certified.
      - `created_at` string, date-time: Time when this resource was created.
      - `data_source_type` 'DATADOG' | 'DATADOG_REFERENCE_TABLE' | 'CUSTOMER_WAREHOUSE' | 'IMPORTED' | 'UNKNOWN': Source of the data used to calculate the metric.
      - `denominator_aggregation` ExperimentsMetricV2DTODataAttributesNumeratorAggregation, nullable: Source measure and aggregation settings for a metric value.
        - `aging_threshold_days` integer: Stored aging threshold in days. The subject aging filter uses the aggregation window end and unit.
        - `datadog_metric_measure` ExperimentsMetricV2DTODataAttributesPercentileAggregationDatadogMetricMeasure: Datadog source and query that supply values for the metric.
          - `column_name` string: Name of the Datadog event field used by this measure.
          - `column_type` string: Data type of the source column.
          - `filters` unknown
          - `name` string: Display name of the Datadog measure.
          - `query` string: Query used to retrieve the Datadog measure.
          - `source_definition_filter` unknown
          - `source_subtype` string: Subtype of the Datadog data source.
          - `source_type` string: Type of Datadog data source used for the measure.
        - `enable_aging_subject_filter` boolean: Whether to exclude subjects whose observation time is shorter than the aggregation window.
        - `operation` string: Aggregation applied to the selected measure.
        - `pipeline_column_suffix` string: Suffix used to identify this value in pipeline output columns.
        - `property_filters` ExperimentsMetricPropertyFilterGroup[]: Filters applied to the metric aggregation.
          - ExperimentsMetricPropertyFilter[]: Metric property filters combined with AND.
            - `measure_id` string: ID of the measure evaluated by the filter.
            - `operation` string: Comparison applied by the filter.
            - `property_id` string: ID of the property evaluated by the filter.
            - `values` string[]: Values used by the filter's comparison.
        - `threshold_aggregation_type` string: Aggregation used to evaluate the threshold.
        - `threshold_breach_value` number, double: Value used to determine whether the threshold is breached.
        - `threshold_comparison_operator` string: Comparison applied between the aggregated value and the threshold.
        - `threshold_timeframe_dimension` string: Time unit used for the threshold evaluation window.
        - `threshold_timeframe_value` number, double: Size of the threshold evaluation window.
        - `timeframe_end_value` number, double: End of the aggregation window in the specified time unit.
        - `timeframe_start_value` number, double: Start of the aggregation window in the specified time unit.
        - `timeframe_unit` string: Time unit used for the aggregation window.
        - `warehouse_metric_measure` ExperimentsMetricV2DTODataAttributesPercentileAggregationWarehouseMetricMeasure: Warehouse measure that supplies values for the metric.
          - `id` string: ID of the measure.
          - `pipeline_column_suffix` string: Suffix used to identify this value in pipeline output columns.
        - `winsor_lower_fixed_value` number, double: Fixed lower bound used to cap metric values.
        - `winsor_lower_percentile` number, double: Percentile used to determine the lower bound for capped metric values.
        - `winsor_upper_fixed_value` number, double: Fixed upper bound used to cap metric values.
        - `winsor_upper_percentile` number, double: Percentile used to determine the upper bound for capped metric values.
        - `winsorization_strategy` string: Method used to cap extreme metric values.
      - `description` string: Text that explains the metric.
      - `desired_change` 'METRIC_INCREASES' | 'METRIC_DECREASES' | 'UNKNOWN': Direction of metric change considered desirable.
      - `experiment_count` integer, nullable: Number of experiments that reference this resource.
      - `format_as_percent` boolean: Whether to display the metric value as a percentage.
      - `guardrail_cutoff_threshold` number, double, nullable: Threshold used when evaluating this metric as a guardrail.
      - `metric_type` 'SIMPLE' | 'RATIO' | 'PERCENTILE' | 'UNKNOWN': Type of metric calculation.
      - `migration_metadata` unknown
      - `name` string: Display name of the metric.
      - `numerator_aggregation` ExperimentsMetricV2DTODataAttributesNumeratorAggregation, nullable: Source measure and aggregation settings for a metric value.
        - `aging_threshold_days` integer: Stored aging threshold in days. The subject aging filter uses the aggregation window end and unit.
        - `datadog_metric_measure` ExperimentsMetricV2DTODataAttributesPercentileAggregationDatadogMetricMeasure: Datadog source and query that supply values for the metric.
          - `column_name` string: Name of the Datadog event field used by this measure.
          - `column_type` string: Data type of the source column.
          - `filters` unknown
          - `name` string: Display name of the Datadog measure.
          - `query` string: Query used to retrieve the Datadog measure.
          - `source_definition_filter` unknown
          - `source_subtype` string: Subtype of the Datadog data source.
          - `source_type` string: Type of Datadog data source used for the measure.
        - `enable_aging_subject_filter` boolean: Whether to exclude subjects whose observation time is shorter than the aggregation window.
        - `operation` string: Aggregation applied to the selected measure.
        - `pipeline_column_suffix` string: Suffix used to identify this value in pipeline output columns.
        - `property_filters` ExperimentsMetricPropertyFilterGroup[]: Filters applied to the metric aggregation.
          - ExperimentsMetricPropertyFilter[]: Metric property filters combined with AND.
            - `measure_id` string: ID of the measure evaluated by the filter.
            - `operation` string: Comparison applied by the filter.
            - `property_id` string: ID of the property evaluated by the filter.
            - `values` string[]: Values used by the filter's comparison.
        - `threshold_aggregation_type` string: Aggregation used to evaluate the threshold.
        - `threshold_breach_value` number, double: Value used to determine whether the threshold is breached.
        - `threshold_comparison_operator` string: Comparison applied between the aggregated value and the threshold.
        - `threshold_timeframe_dimension` string: Time unit used for the threshold evaluation window.
        - `threshold_timeframe_value` number, double: Size of the threshold evaluation window.
        - `timeframe_end_value` number, double: End of the aggregation window in the specified time unit.
        - `timeframe_start_value` number, double: Start of the aggregation window in the specified time unit.
        - `timeframe_unit` string: Time unit used for the aggregation window.
        - `warehouse_metric_measure` ExperimentsMetricV2DTODataAttributesPercentileAggregationWarehouseMetricMeasure: Warehouse measure that supplies values for the metric.
          - `id` string: ID of the measure.
          - `pipeline_column_suffix` string: Suffix used to identify this value in pipeline output columns.
        - `winsor_lower_fixed_value` number, double: Fixed lower bound used to cap metric values.
        - `winsor_lower_percentile` number, double: Percentile used to determine the lower bound for capped metric values.
        - `winsor_upper_fixed_value` number, double: Fixed upper bound used to cap metric values.
        - `winsor_upper_percentile` number, double: Percentile used to determine the upper bound for capped metric values.
        - `winsorization_strategy` string: Method used to cap extreme metric values.
      - `percentile_aggregation` ExperimentsMetricV2DTODataAttributesPercentileAggregation, nullable: Source measure and settings for a percentile metric.
        - `datadog_metric_measure` ExperimentsMetricV2DTODataAttributesPercentileAggregationDatadogMetricMeasure: Datadog source and query that supply values for the metric.
          - `column_name` string: Name of the Datadog event field used by this measure.
          - `column_type` string: Data type of the source column.
          - `filters` unknown
          - `name` string: Display name of the Datadog measure.
          - `query` string: Query used to retrieve the Datadog measure.
          - `source_definition_filter` unknown
          - `source_subtype` string: Subtype of the Datadog data source.
          - `source_type` string: Type of Datadog data source used for the measure.
        - `percentile` number, double: Percentile calculated from the selected measure.
        - `pipeline_column_suffix` string: Suffix used to identify this value in pipeline output columns.
        - `property_filters` ExperimentsMetricPropertyFilterGroup[]: Filters applied to the metric aggregation.
          - ExperimentsMetricPropertyFilter[]: Metric property filters combined with AND.
            - `measure_id` string: ID of the measure evaluated by the filter.
            - `operation` string: Comparison applied by the filter.
            - `property_id` string: ID of the property evaluated by the filter.
            - `values` string[]: Values used by the filter's comparison.
        - `warehouse_metric_measure` ExperimentsMetricV2DTODataAttributesPercentileAggregationWarehouseMetricMeasure: Warehouse measure that supplies values for the metric.
          - `id` string: ID of the measure.
          - `pipeline_column_suffix` string: Suffix used to identify this value in pipeline output columns.
      - `reference_url` string: URL with supporting information about the metric.
      - `updated_at` string, date-time: Time when this resource was last updated.
    - `id` string, uuid, required: ID of the metric.
    - `type` 'metrics', required: The metric resource type.

## Other responses

- `400`: Malformed ID or body, or validation failure.
- `401`: Missing or invalid authentication.
- `403`: Caller lacks product_analytics_metrics_write or edit access to this specific metric.
- `404`: No metric with this ID exists for the organization.
- `409`: The metric is imported, certified, or managed by metric sync, or another metric in this organization already uses one of these values.
- `415`: Request body sent with a media type other than application/json or application/vnd.api+json.
- `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/3f70db624329?raw)
