From 88a04ecdf0ff0911fafb5fa8634e24060c9f52eb Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 26 May 2026 03:36:39 +0000
Subject: [PATCH] docs: document deck tags field on list and update endpoints

---
 openapi.json | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/openapi.json b/openapi.json
index 7606f85..bec3474 100644
--- a/openapi.json
+++ b/openapi.json
@@ -95,10 +95,11 @@
           "type": { "type": "string", "enum": ["structured", "image-based"] },
           "isActive": { "type": "boolean" },
           "previewImageUrl": { "type": "string", "format": "uri", "nullable": true, "description": "Presigned URL for the first slide image" },
+          "tags": { "type": "array", "items": { "type": "string" }, "description": "Free-form labels stored on the deck metadata. Defaults to an empty array.", "default": [] },
           "createdAt": { "type": "string", "format": "date-time" },
           "updatedAt": { "type": "string", "format": "date-time" }
         },
-        "required": ["id", "name", "type", "isActive", "createdAt", "updatedAt"]
+        "required": ["id", "name", "type", "isActive", "tags", "createdAt", "updatedAt"]
       },
       "Slide": {
         "type": "object",
@@ -586,7 +587,8 @@
                   "description": { "type": "string", "nullable": true },
                   "type": { "type": "string", "enum": ["structured", "image-based"] },
                   "isActive": { "type": "boolean" },
-                  "deckContext": { "type": "string", "nullable": true }
+                  "deckContext": { "type": "string", "nullable": true },
+                  "tags": { "type": "array", "items": { "type": "string" }, "nullable": true, "description": "Replaces the deck's tag list. Pass an empty array or `null` to clear all tags. Falsy entries are filtered out." }
                 }
               }
             }