From c70c864b8105c61a8f47f439b22a72b1919d468c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nuno=20G=C3=B3is?= <github@nunogois.com>
Date: Tue, 2 Sep 2025 11:45:21 +0100
Subject: [PATCH] chore: promote unknown flags to a stable OpenAPI tag (#10594)

https://linear.app/unleash/issue/2-3832/promote-api-to-a-stable-openapi-tag

Promotes the Unknown Flags API to a stable OpenAPI tag as we prepare for
GA.
---
 .../metrics/unknown-flags/unknown-flags-controller.ts         | 4 ++--
 src/lib/openapi/util/openapi-tags.ts                          | 4 ++++
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/lib/features/metrics/unknown-flags/unknown-flags-controller.ts b/src/lib/features/metrics/unknown-flags/unknown-flags-controller.ts
index 2352c2a34d..65c7cc11b0 100644
--- a/src/lib/features/metrics/unknown-flags/unknown-flags-controller.ts
+++ b/src/lib/features/metrics/unknown-flags/unknown-flags-controller.ts
@@ -42,8 +42,8 @@ export default class UnknownFlagsController extends Controller {
             middleware: [
                 openApiService.validPath({
                     operationId: 'getUnknownFlags',
-                    tags: ['Unstable'],
-                    summary: 'Get unknown flag reports',
+                    tags: ['Unknown Flags'],
+                    summary: 'Get unknown flags',
                     description:
                         'Returns a list of unknown flag reports from the last 24 hours, if any. Maximum of 1000.',
                     responses: {
diff --git a/src/lib/openapi/util/openapi-tags.ts b/src/lib/openapi/util/openapi-tags.ts
index 0da46175dc..f5e7222861 100644
--- a/src/lib/openapi/util/openapi-tags.ts
+++ b/src/lib/openapi/util/openapi-tags.ts
@@ -146,6 +146,10 @@ const OPENAPI_TAGS = [
         name: 'Telemetry',
         description: 'API for information about telemetry collection',
     },
+    {
+        name: 'Unknown Flags',
+        description: 'Endpoints related to unknown flags.',
+    },
     {
         name: 'Unleash Edge',
         description: