For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/fr/api/latest/experiments/set-default-subject-type.md. A documentation index is available at /llms.txt.
homeAccueildocsDocumentationapiAPI
Language
Datadog site
ATTENTIONCe produit n'est pas pris en charge par le site Datadog que vous avez sélectionné. (US1-FED).
ATTENTIONCe produit n'est pas pris en charge par le site Datadog que vous avez sélectionné. (US2-FED).

Set default subject type

POSThttps://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}/defaulthttps://api.datadoghq.eu/api/v2/experiments/subject-types/{subject_type_id}/defaulthttps://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.uk1.datadoghq.com/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}/default

Présentation

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

Paramètres du chemin

Name
Type
Description
subject_type_id [required]
string

The UUID of the subject type.

Réponse

The subject type is now the organization's default.

Exemple de code

Set default subject type
# Path parameters
export subject_type_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/subject-types/${subject_type_id}/default" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export subject_type_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/subject-types/${subject_type_id}/default" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export subject_type_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/subject-types/${subject_type_id}/default" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export subject_type_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/subject-types/${subject_type_id}/default" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export subject_type_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/subject-types/${subject_type_id}/default" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export subject_type_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/subject-types/${subject_type_id}/default" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export subject_type_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/subject-types/${subject_type_id}/default" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export subject_type_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/subject-types/${subject_type_id}/default" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Path parameters
export subject_type_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/subject-types/${subject_type_id}/default" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"