@remit/api-openapi-spec 0.0.101 → 0.0.102

package/openapi.json

@@ -6925,6 +6925,15 @@
               "$ref": "#/components/schemas/UUID"
             }
           },
+          {
+            "name": "labelId",
+            "in": "query",
+            "required": false,
+            "description": "List one label across every account: replaces the INBOX scope with that label's folder in each non-muted account. Composes with `query`, the field and row filters, `accountId`, `mailboxId` and `count` as a further narrowing of the same scope. A label the caller does not own matches nothing.",
+            "schema": {
+              "$ref": "#/components/schemas/UUID"
+            }
+          },
           {
             "name": "muted",
             "in": "query",
@@ -11932,6 +11941,73 @@
         ],
         "description": "Display color for a user-defined Label (RFC 030)."
       },
+      "RemitImap.LabelFolder": {
+        "anyOf": [
+          {
+            "$ref": "#/components/schemas/RemitImap.LabelFolderPresent"
+          },
+          {
+            "$ref": "#/components/schemas/RemitImap.LabelFolderMissing"
+          }
+        ],
+        "description": "Where a label lives in one mail account, the same shape the MCP `list_labels` tool returns."
+      },
+      "RemitImap.LabelFolderMissing": {
+        "type": "object",
+        "required": [
+          "accountId",
+          "state"
+        ],
+        "properties": {
+          "accountId": {
+            "$ref": "#/components/schemas/UUID"
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "Missing"
+            ]
+          }
+        },
+        "description": "A mail account that holds no folder for the label."
+      },
+      "RemitImap.LabelFolderPresent": {
+        "type": "object",
+        "required": [
+          "accountId",
+          "state",
+          "mailboxId",
+          "fullPath"
+        ],
+        "properties": {
+          "accountId": {
+            "$ref": "#/components/schemas/UUID"
+          },
+          "state": {
+            "anyOf": [
+              {
+                "type": "string",
+                "enum": [
+                  "Present"
+                ]
+              },
+              {
+                "type": "string",
+                "enum": [
+                  "Pending"
+                ]
+              }
+            ]
+          },
+          "mailboxId": {
+            "$ref": "#/components/schemas/UUID"
+          },
+          "fullPath": {
+            "$ref": "#/components/schemas/String512"
+          }
+        },
+        "description": "A label's folder in one mail account, as `Present` (synced) or `Pending` (the mail server has not confirmed it yet)."
+      },
       "RemitImap.LabelResponse": {
         "type": "object",
         "required": [
@@ -11941,7 +12017,8 @@
           "color",
           "createdAt",
           "updatedAt",
-          "filterCount"
+          "filterCount",
+          "folders"
         ],
         "properties": {
           "labelId": {
@@ -11993,6 +12070,13 @@
             "type": "integer",
             "format": "int32",
             "description": "Number of the account's filters whose `actionLabelId` is this label. Deleting the label deletes every one of them (issue #26) — a client shows this count in its delete confirmation."
+          },
+          "folders": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RemitImap.LabelFolder"
+            },
+            "description": "The label's folder in every mail account of the config, one entry per account."
           }
         },
         "description": "Label item returned by list/get/create/update operations (RFC 030). `filterCount` is computed at read time so a client can name the blast radius before confirming a delete — the delete itself never blocks on it (issue #26)."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/api-openapi-spec",
-  "version": "0.0.101",
+  "version": "0.0.102",
   "description": "Remit API OpenAPI 3 document, generated from TypeSpec, and its precompiled request validators.",
   "exports": {
     ".": "./openapi.json",