Note: This endpoint is in preview and is subject to change.
If you have any feedback, contact Datadog support.
GET https://api.ap1.datadoghq.com/api/v2/model-lab-api/facet-valueshttps://api.ap2.datadoghq.com/api/v2/model-lab-api/facet-valueshttps://api.datadoghq.eu/api/v2/model-lab-api/facet-valueshttps://api.ddog-gov.com/api/v2/model-lab-api/facet-valueshttps://api.us2.ddog-gov.com/api/v2/model-lab-api/facet-valueshttps://api.datadoghq.com/api/v2/model-lab-api/facet-valueshttps://api.us3.datadoghq.com/api/v2/model-lab-api/facet-valueshttps://api.us5.datadoghq.com/api/v2/model-lab-api/facet-values
Overview
List available facet values for a specific run facet key.
Arguments
Query Strings
filter[project_id] [required]
Facet type. Valid values: parameter, attribute, tag, metric.
Allowed enum values: parameter, attribute, tag, metric
Response
OK
Response containing available values for a facet key.
Expand All
A facet values JSON:API resource object.
Available values for a specific facet key.
The ranges for each metric statistic.
The maximum value of the statistic.
The minimum value of the statistic.
The metric statistic name.
The numeric range of values for a facet.
The list of available string values for this facet.
The unique identifier of the facet values resource.
The JSON:API type for a facet values resource.
Allowed enum values: facet_values
{
"data": {
"attributes": {
"facet_name": "model",
"facet_type": "tag",
"metric_stat_ranges": [
{
"max": 1,
"min": 0,
"stat": "mean"
}
],
"numeric_range": {
"max": 1,
"min": 0
},
"values": [
"gpt4"
]
},
"id": "1",
"type": "facet_values"
}
}
Bad Request
API error response.
Expand All
A human-readable explanation specific to this occurrence of the error.
Non-standard meta-information about the error
References to the source of the error.
A string indicating the name of a single request header which caused the error.
A string indicating which URI query parameter caused the error.
A JSON pointer to the value in the request document that caused the error.
Status code of the response.
Short human-readable summary of the error.
{
"errors": [
{
"detail": "Missing required attribute in body",
"meta": {},
"source": {
"header": "Authorization",
"parameter": "limit",
"pointer": "/data/attributes/title"
},
"status": "400",
"title": "Bad Request"
}
]
}
Not Found
API error response.
Expand All
A human-readable explanation specific to this occurrence of the error.
Non-standard meta-information about the error
References to the source of the error.
A string indicating the name of a single request header which caused the error.
A string indicating which URI query parameter caused the error.
A JSON pointer to the value in the request document that caused the error.
Status code of the response.
Short human-readable summary of the error.
{
"errors": [
{
"detail": "Missing required attribute in body",
"meta": {},
"source": {
"header": "Authorization",
"parameter": "limit",
"pointer": "/data/attributes/title"
},
"status": "400",
"title": "Bad Request"
}
]
}
Too many requests
{
"errors": [
"Bad Request"
]
}
Internal Server Error
API error response.
Expand All
A human-readable explanation specific to this occurrence of the error.
Non-standard meta-information about the error
References to the source of the error.
A string indicating the name of a single request header which caused the error.
A string indicating which URI query parameter caused the error.
A JSON pointer to the value in the request document that caused the error.
Status code of the response.
Short human-readable summary of the error.
{
"errors": [
{
"detail": "Missing required attribute in body",
"meta": {},
"source": {
"header": "Authorization",
"parameter": "limit",
"pointer": "/data/attributes/title"
},
"status": "400",
"title": "Bad Request"
}
]
}
Code Example
# Required query arguments
export filter[project_id]="101"
export facet_type="tag"
export facet_name="algorithm"
# Curl command
curl -X GET "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.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/model-lab-api/facet-values?filter[project_id]=${filter[project_id]}&facet_type=${facet_type}&facet_name=${facet_name}" \
-H "Accept: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
