definition
Query available filter definitions for observability
Returns the list of available filter definitions that can be applied to observability queries, including their operators, types, and value constraints.
Use signal to narrow the catalog to the filters a given surface can actually honour — for example ?signal=LOGS on the logs table. Without it, the whole catalog is returned, which includes filters no single query path supports end to end.
get/environments/{envId}/observability/filters/definition
Path parameters
envIdstring required
The unique ID of your environment
Query parameters
signalSignal[]
Observability signal(s) to narrow the catalog by. Repeat for multiple values.
[ "LOGS" ]
Response
The response contains the available filter definitions for observability features, including their supported operators, types, and optional enum values or ranges.
Example response
{
"data": [
{
"name": "API",
"label": "API",
"type": "KEYWORD",
"operators": [
"EQ",
"IN"
]
},
{
"name": "HTTP_METHOD",
"label": "HTTP Method",
"type": "ENUM",
"operators": [
"EQ",
"IN"
],
"enumValues": [
"GET",
"POST",
"PUT"
]
},
{
"name": "HTTP_STATUS",
"label": "Status Code",
"type": "NUMBER",
"operators": [
"EQ",
"LTE",
"GTE"
],
"range": {
"min": 100,
"max": 600
}
}
]
}