Set default subject type

POST https://api.ap1.datadoghq.com/api/v2/experiments/subject-types/{subject_type_id}/defaulthttps://api.ap2.datadoghq.com/api/v2/experiments/subject-types/{subject_type_id}/defaulthttps://api.datadoghq.eu/api/v2/experiments/subject-types/{subject_type_id}/defaulthttps://api.ddog-gov.com/api/v2/experiments/subject-types/{subject_type_id}/defaulthttps://api.us2.ddog-gov.com/api/v2/experiments/subject-types/{subject_type_id}/defaulthttps://api.uk1.datadoghq.com/api/v2/experiments/subject-types/{subject_type_id}/defaulthttps://api.datadoghq.com/api/v2/experiments/subject-types/{subject_type_id}/defaulthttps://api.us3.datadoghq.com/api/v2/experiments/subject-types/{subject_type_id}/defaulthttps://api.us5.datadoghq.com/api/v2/experiments/subject-types/{subject_type_id}/default

Overview

Make this subject type the organization’s default. Experiment creation uses the default when the request names no subject type. Promoting one subject type demotes the previous default in the same transaction, so the organization always has exactly one. The call is idempotent: promoting the current default succeeds and changes nothing. There is no matching demote, because an organization cannot have no default; promote a different subject type instead. This endpoint requires the product_analytics_settings_write permission.

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

Arguments

Path Parameters

Response

• 204
• 400
• 401
• 403
• 404
• 429

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

{
  "errors": [
    {
      "detail": "Missing required attribute in body",
      "meta": {},
      "source": {
        "header": "Authorization",
        "parameter": "limit",
        "pointer": "/data/attributes/title"
      },
      "status": "400",
      "title": "Bad Request"
    }
  ]
}

{
  "errors": [
    "Bad Request"
  ]
}

Code Example

                  # Path parameters
export subject_type_id="550e8400-e29b-41d4-a716-446655440000"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

# Curl command
curl -X POST "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.uk1.datadoghq.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/experiments/subject-types/${subject_type_id}/default" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"