From 247dd3af519a005efe1076e43b018f2aaf470cec Mon Sep 17 00:00:00 2001
From: andrii-st <143264652+andrii-st@users.noreply.github.com>
Date: Thu, 9 Oct 2025 10:40:35 +0200
Subject: [PATCH] docs: clarify `archived` query param syntax for
 `api/admin/search/features` (#10538)

## About the changes
This PR updates the [Search and filter
features](https://docs.getunleash.io/reference/api/unleash/search-features)
doc to clearly indicate `IS:` query syntax requirement for `archived`
query param.
---
 src/lib/openapi/spec/feature-search-query-parameters.ts | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/lib/openapi/spec/feature-search-query-parameters.ts b/src/lib/openapi/spec/feature-search-query-parameters.ts
index c4cfc7512b..52ebf8237d 100644
--- a/src/lib/openapi/spec/feature-search-query-parameters.ts
+++ b/src/lib/openapi/spec/feature-search-query-parameters.ts
@@ -163,9 +163,10 @@ export const featureSearchQueryParameters = [
         schema: {
             type: 'string',
             example: 'IS:true',
+            pattern: '^IS:(true|false)$',
         },
         description:
-            'Whether to get results for archived feature flags or active feature flags. If `true`, Unleash will return only archived flags. If `false`, it will return only active flags.',
+            'Whether to get results for archived feature flags or active feature flags. If `IS:true`, Unleash will return only archived flags. If `IS:false`, it will return only active flags.',
         in: 'query',
     },
     {