Skip to content

Update description for filter param in OpenAPI#4775

Merged
SuperQ merged 1 commit intoprometheus:mainfrom
waltherlee:update-api-v2-doc-for-alert-filters
Dec 5, 2025
Merged

Update description for filter param in OpenAPI#4775
SuperQ merged 1 commit intoprometheus:mainfrom
waltherlee:update-api-v2-doc-for-alert-filters

Conversation

@waltherlee
Copy link
Member

@waltherlee waltherlee commented Nov 30, 2025

Re: #2812

filter is an array, but multiple items have to be added by repeating the param. This can be confusing since "a list of matchers" could be understood as a list separated by comma in a single value, or a group of matchers in promql format.

I'm changing the description to explicitly say that the value has to be a single matcher expression, but multiple values can be applied by repeating the param. Also fixed a typo in alert groups that said "alerts" instead of "alert groups".

The main change is in api/v2/openapi.yaml. All the others were autogenerated with make apiv2

Signed-off-by: Walther Lee <walthere.lee@gmail.com>
@waltherlee waltherlee force-pushed the update-api-v2-doc-for-alert-filters branch from 9ff3635 to 1d1b808 Compare November 30, 2025 04:30
@SuperQ SuperQ merged commit 707e4c8 into prometheus:main Dec 5, 2025
7 checks passed
@SoloJacobs SoloJacobs mentioned this pull request Dec 7, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants