For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/experiments/create-experiment-metric-group.md. A documentation index is available at /llms.txt.
Language
Datadog site
CAUTIONThis product is not supported for your selected Datadog site. (US1-FED).
CAUTIONThis product is not supported for your selected Datadog site. (US2-FED).

Create experiment metric group

POSThttps://api.datadoghq.com/api/v2/experiments/{experiment_id}/metric-groupshttps://api.us3.datadoghq.com/api/v2/experiments/{experiment_id}/metric-groupshttps://api.us5.datadoghq.com/api/v2/experiments/{experiment_id}/metric-groupshttps://api.datadoghq.eu/api/v2/experiments/{experiment_id}/metric-groupshttps://api.ap1.datadoghq.com/api/v2/experiments/{experiment_id}/metric-groupshttps://api.ap2.datadoghq.com/api/v2/experiments/{experiment_id}/metric-groupshttps://api.uk1.datadoghq.com/api/v2/experiments/{experiment_id}/metric-groupshttps://api.ddog-gov.com/api/v2/experiments/{experiment_id}/metric-groupshttps://api.us2.ddog-gov.com/api/v2/experiments/{experiment_id}/metric-groups

Overview

Create a non-decision metric group. The optional metrics array is ordered. Decision groups remain managed through decision_metrics on the experiment resource. This operation does not synchronously recompute results.

This endpoint requires the product_analytics_experiments_write permission.

OAuth apps require the product_analytics_experiments_write authorization scope to access this endpoint.

Arguments

Path Parameters

Name
Type
Description
experiment_id [required]
string

The UUID of the experiment.

Request

Body Data (required)

Field
Type
Description
data [required]
object

Metric group resource to create on the experiment.

Response

Created

Response containing the saved experiment metric group and result refresh information.

Field
Type
Description
data [required]
object

Experiment metric group resource with its identifier and metric selection.

meta
object

Refresh requirements and warnings returned by an experiment update.

Code Example

Create experiment metric group returns "Created" response
# Path parameters
export experiment_id="550e8400-e29b-41d4-a716-446655440000"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/experiments/${experiment_id}/metric-groups" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "experiment-metric-groups",
    "attributes": {
      "name": "ex-14bb9543f523edde",
      "metrics": [
        {
          "metric_id": "550e8400-e29b-41d4-a716-446655440002"
        }
      ]
    }
  }
}
EOF
# Path parameters
export experiment_id="550e8400-e29b-41d4-a716-446655440000"

# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/experiments/${experiment_id}/metric-groups" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "experiment-metric-groups",
    "attributes": {
      "name": "ex-14bb9543f523edde",
      "metrics": [
        {
          "metric_id": "550e8400-e29b-41d4-a716-446655440002"
        }
      ]
    }
  }
}
EOF
# Path parameters
export experiment_id="550e8400-e29b-41d4-a716-446655440000"

# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/experiments/${experiment_id}/metric-groups" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "experiment-metric-groups",
    "attributes": {
      "name": "ex-14bb9543f523edde",
      "metrics": [
        {
          "metric_id": "550e8400-e29b-41d4-a716-446655440002"
        }
      ]
    }
  }
}
EOF
# Path parameters
export experiment_id="550e8400-e29b-41d4-a716-446655440000"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/experiments/${experiment_id}/metric-groups" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "experiment-metric-groups",
    "attributes": {
      "name": "ex-14bb9543f523edde",
      "metrics": [
        {
          "metric_id": "550e8400-e29b-41d4-a716-446655440002"
        }
      ]
    }
  }
}
EOF
# Path parameters
export experiment_id="550e8400-e29b-41d4-a716-446655440000"

# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/experiments/${experiment_id}/metric-groups" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "experiment-metric-groups",
    "attributes": {
      "name": "ex-14bb9543f523edde",
      "metrics": [
        {
          "metric_id": "550e8400-e29b-41d4-a716-446655440002"
        }
      ]
    }
  }
}
EOF
# Path parameters
export experiment_id="550e8400-e29b-41d4-a716-446655440000"

# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/experiments/${experiment_id}/metric-groups" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "experiment-metric-groups",
    "attributes": {
      "name": "ex-14bb9543f523edde",
      "metrics": [
        {
          "metric_id": "550e8400-e29b-41d4-a716-446655440002"
        }
      ]
    }
  }
}
EOF
# Path parameters
export experiment_id="550e8400-e29b-41d4-a716-446655440000"

# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/experiments/${experiment_id}/metric-groups" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "experiment-metric-groups",
    "attributes": {
      "name": "ex-14bb9543f523edde",
      "metrics": [
        {
          "metric_id": "550e8400-e29b-41d4-a716-446655440002"
        }
      ]
    }
  }
}
EOF
# Path parameters
export experiment_id="550e8400-e29b-41d4-a716-446655440000"

# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/experiments/${experiment_id}/metric-groups" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "experiment-metric-groups",
    "attributes": {
      "name": "ex-14bb9543f523edde",
      "metrics": [
        {
          "metric_id": "550e8400-e29b-41d4-a716-446655440002"
        }
      ]
    }
  }
}
EOF
# Path parameters
export experiment_id="550e8400-e29b-41d4-a716-446655440000"

# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/experiments/${experiment_id}/metric-groups" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "type": "experiment-metric-groups",
    "attributes": {
      "name": "ex-14bb9543f523edde",
      "metrics": [
        {
          "metric_id": "550e8400-e29b-41d4-a716-446655440002"
        }
      ]
    }
  }
}
EOF