@snokam/mcp-api 2.34.0 → 2.36.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "2.34.0",
+  "version": "2.36.0",
   "description": "MCP server exposing Snokam backend APIs as tools for Claude Code and other MCP clients",
   "type": "module",
   "bin": {

package/specs/production/blog.json

@@ -208,6 +208,278 @@
         ]
       }
     },
+    "/v1.0/protected/articles/{slugOrId}/draft-status": {
+      "get": {
+        "tags": [
+          "Articles"
+        ],
+        "summary": "Get article with draft status",
+        "description": "Returns both the published article and any pending draft so authors can compare states. Only authors may call this.",
+        "operationId": "GetArticleWithDraft",
+        "parameters": [
+          {
+            "name": "slugOrId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The slug or id of the article"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Snapshot with published + draft sides",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/getArticleWithDraftResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://e60092d3-3970-4a7c-a62e-19f17c4bca08/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/articles/drafts": {
+      "post": {
+        "tags": [
+          "Articles"
+        ],
+        "summary": "Create a new article as a draft",
+        "description": "Creates a new article in Sanity's `drafts.*` namespace. The article is not visible on the public site until PublishDraft is called.",
+        "operationId": "CreateDraft",
+        "requestBody": {
+          "description": "The article content to save as a draft",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sanityCreateArticle"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "The newly created draft",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/getArticlesBySlugOrIdResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "400": {
+            "description": "Payload of Object",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            },
+            "x-ms-summary": "Bad Request"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://e60092d3-3970-4a7c-a62e-19f17c4bca08/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/articles/{slugOrId}/draft": {
+      "patch": {
+        "tags": [
+          "Articles"
+        ],
+        "summary": "Write an edit to the draft",
+        "description": "Patches the draft for the given article. Creates the draft from the published copy first if none exists. Only authors may call this.",
+        "operationId": "PatchDraft",
+        "parameters": [
+          {
+            "name": "slugOrId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The slug or id of the article"
+          }
+        ],
+        "requestBody": {
+          "description": "Fields to merge into the draft",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sanityPatchArticle"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "The updated draft",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/getArticlesBySlugOrIdResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "400": {
+            "description": "Payload of Object",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            },
+            "x-ms-summary": "Bad Request"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://e60092d3-3970-4a7c-a62e-19f17c4bca08/.default"
+            ]
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "Articles"
+        ],
+        "summary": "Delete the draft",
+        "description": "Removes the draft without touching the published article. Only authors may call this.",
+        "operationId": "DiscardDraft",
+        "parameters": [
+          {
+            "name": "slugOrId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The slug or id of the article"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The discarded draft (pre-delete snapshot)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/getArticlesBySlugOrIdResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No draft exists",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://e60092d3-3970-4a7c-a62e-19f17c4bca08/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/articles/{slugOrId}/publish": {
+      "post": {
+        "tags": [
+          "Articles"
+        ],
+        "summary": "Promote the draft to published",
+        "description": "Overwrites the published article with the current draft and removes the draft. Only authors may call this.",
+        "operationId": "PublishDraft",
+        "parameters": [
+          {
+            "name": "slugOrId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The slug or id of the article"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The newly-published article",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/getArticlesBySlugOrIdResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No draft exists",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://e60092d3-3970-4a7c-a62e-19f17c4bca08/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/protected/{slugOrId}/article-invitation-preview": {
       "get": {
         "tags": [
@@ -622,6 +894,32 @@
           }
         }
       },
+      "getArticleWithDraftResult": {
+        "type": "object",
+        "properties": {
+          "draft": {
+            "$ref": "#/components/schemas/getArticlesBySlugOrIdResult"
+          },
+          "hasDraft": {
+            "type": "boolean"
+          },
+          "hasPublished": {
+            "type": "boolean"
+          },
+          "published": {
+            "$ref": "#/components/schemas/getArticlesBySlugOrIdResult"
+          },
+          "publishedId": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object"
+            }
+          }
+        }
+      },
       "muxVideo": {
         "type": "object",
         "properties": {

package/specs/production/sales.json

@@ -2449,6 +2449,53 @@
         ]
       }
     },
+    "/v1.0/tenders/{id}/slack-messages": {
+      "post": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Queue a Slack message for a tender (Service Bus → notifications-function).",
+        "operationId": "SendTenderSlackMessage",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sendTenderSlackMessageRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "204": {
+            "description": "No description"
+          },
+          "400": {
+            "description": "No description"
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://7e877854-e62d-4637-a655-1da7141f7ac9/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/tenders/{id}/consultants/{email}": {
       "delete": {
         "tags": [
@@ -3779,6 +3826,19 @@
           }
         }
       },
+      "sendTenderSlackMessageRequest": {
+        "type": "object",
+        "properties": {
+          "channelId": {
+            "type": "string",
+            "nullable": true
+          },
+          "message": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
       "sourceFile": {
         "type": "object",
         "properties": {

package/specs/production/sanity.json

@@ -34406,6 +34406,49 @@
         "type": "object",
         "additionalProperties": true
       },
+      "GetArticleWithDraftResult": {
+        "description": "Snapshot combining the published version and any in-progress\ndraft. Used by the editor UI so authors can see both states and\ndecide when to promote.",
+        "properties": {
+          "publishedId": {
+            "type": "string",
+            "nullable": true,
+            "description": "Canonical published id (no `drafts.` prefix). `null` when the\narticle only exists as a draft (freshly created)."
+          },
+          "published": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+              }
+            ],
+            "nullable": true,
+            "description": "Published article, renamed-field form. `null` if never published."
+          },
+          "draft": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+              }
+            ],
+            "nullable": true,
+            "description": "Draft article (from `drafts.<id>`), renamed-field form. `null`\nwhen the article has no pending draft."
+          },
+          "hasPublished": {
+            "type": "boolean"
+          },
+          "hasDraft": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "publishedId",
+          "published",
+          "draft",
+          "hasPublished",
+          "hasDraft"
+        ],
+        "type": "object",
+        "additionalProperties": true
+      },
       "GetAppByKeyResult": {
         "properties": {
           "menu": {
@@ -50017,6 +50060,210 @@
         ]
       }
     },
+    "/v1.0/articles/{slugOrId}/draft-status": {
+      "get": {
+        "operationId": "GetArticleWithDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticleWithDraftResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Read both states at once. Returns all `null`s if neither exists.\nAccepts a published id or a slug; draft lookup is by id, so we\nresolve slug→id via the published GROQ query first. Brand-new\ndrafts (no published counterpart) can be fetched by passing the\nbare `drafts.<id>` form or the plain `<id>` half — the handler\ntries both.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "slugOrId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ]
+      }
+    },
+    "/v1.0/articles/drafts": {
+      "post": {
+        "operationId": "CreateDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Create a brand-new article as a draft. Returns the created\ndraft document (its `sanityId` carries the `drafts.` prefix).\nAuthors use this from the \"New article\" flow so nothing goes\nlive until they press publish.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityCreateArticle"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1.0/articles/{slugOrId}/draft": {
+      "patch": {
+        "operationId": "PatchDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Write an edit to the draft for `slugOrId`. If no draft exists\nwe clone the published document first, so partial patches\npreserve existing content. `slugOrId` must resolve to a document\nid — callers coming in via slug should go through blog-function\n(which resolves with GetArticleWithDraft before calling this)\nso the authZ check and slug→id resolution happen together.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "slugOrId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityPatchArticle"
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "DiscardDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+                    }
+                  ],
+                  "nullable": true
+                }
+              }
+            }
+          }
+        },
+        "description": "Delete the draft for `slugOrId` without touching the published\ndocument. Returns the discarded draft (pre-delete snapshot) or\n`null` if no draft existed.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "slugOrId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ]
+      }
+    },
+    "/v1.0/articles/{slugOrId}/publish": {
+      "post": {
+        "operationId": "PublishDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Promote the draft for `slugOrId` to published. Overwrites the\npublished document with the draft's content and deletes the\ndraft. Returns the newly-published document.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://3358ac8e-681e-4aeb-bfbf-bb008913c423/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "slugOrId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ]
+      }
+    },
     "/v1.0/apps": {
       "get": {
         "operationId": "GetApps",

package/specs/test/blog.json

@@ -208,6 +208,278 @@
         ]
       }
     },
+    "/v1.0/protected/articles/{slugOrId}/draft-status": {
+      "get": {
+        "tags": [
+          "Articles"
+        ],
+        "summary": "Get article with draft status",
+        "description": "Returns both the published article and any pending draft so authors can compare states. Only authors may call this.",
+        "operationId": "GetArticleWithDraft",
+        "parameters": [
+          {
+            "name": "slugOrId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The slug or id of the article"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Snapshot with published + draft sides",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/getArticleWithDraftResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://c375ccd2-e69d-4262-808d-1a197df95d34/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/articles/drafts": {
+      "post": {
+        "tags": [
+          "Articles"
+        ],
+        "summary": "Create a new article as a draft",
+        "description": "Creates a new article in Sanity's `drafts.*` namespace. The article is not visible on the public site until PublishDraft is called.",
+        "operationId": "CreateDraft",
+        "requestBody": {
+          "description": "The article content to save as a draft",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sanityCreateArticle"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "The newly created draft",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/getArticlesBySlugOrIdResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "400": {
+            "description": "Payload of Object",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            },
+            "x-ms-summary": "Bad Request"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://c375ccd2-e69d-4262-808d-1a197df95d34/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/articles/{slugOrId}/draft": {
+      "patch": {
+        "tags": [
+          "Articles"
+        ],
+        "summary": "Write an edit to the draft",
+        "description": "Patches the draft for the given article. Creates the draft from the published copy first if none exists. Only authors may call this.",
+        "operationId": "PatchDraft",
+        "parameters": [
+          {
+            "name": "slugOrId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The slug or id of the article"
+          }
+        ],
+        "requestBody": {
+          "description": "Fields to merge into the draft",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sanityPatchArticle"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "The updated draft",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/getArticlesBySlugOrIdResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "400": {
+            "description": "Payload of Object",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            },
+            "x-ms-summary": "Bad Request"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No description",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://c375ccd2-e69d-4262-808d-1a197df95d34/.default"
+            ]
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "Articles"
+        ],
+        "summary": "Delete the draft",
+        "description": "Removes the draft without touching the published article. Only authors may call this.",
+        "operationId": "DiscardDraft",
+        "parameters": [
+          {
+            "name": "slugOrId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The slug or id of the article"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The discarded draft (pre-delete snapshot)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/getArticlesBySlugOrIdResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No draft exists",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://c375ccd2-e69d-4262-808d-1a197df95d34/.default"
+            ]
+          }
+        ]
+      }
+    },
+    "/v1.0/protected/articles/{slugOrId}/publish": {
+      "post": {
+        "tags": [
+          "Articles"
+        ],
+        "summary": "Promote the draft to published",
+        "description": "Overwrites the published article with the current draft and removes the draft. Only authors may call this.",
+        "operationId": "PublishDraft",
+        "parameters": [
+          {
+            "name": "slugOrId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "x-ms-summary": "The slug or id of the article"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The newly-published article",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/getArticlesBySlugOrIdResult"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          },
+          "401": {
+            "description": "No description",
+            "x-ms-summary": "Unauthorized"
+          },
+          "404": {
+            "description": "No draft exists",
+            "x-ms-summary": "Not Found"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://c375ccd2-e69d-4262-808d-1a197df95d34/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/protected/{slugOrId}/article-invitation-preview": {
       "get": {
         "tags": [
@@ -622,6 +894,32 @@
           }
         }
       },
+      "getArticleWithDraftResult": {
+        "type": "object",
+        "properties": {
+          "draft": {
+            "$ref": "#/components/schemas/getArticlesBySlugOrIdResult"
+          },
+          "hasDraft": {
+            "type": "boolean"
+          },
+          "hasPublished": {
+            "type": "boolean"
+          },
+          "published": {
+            "$ref": "#/components/schemas/getArticlesBySlugOrIdResult"
+          },
+          "publishedId": {
+            "type": "string"
+          },
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object"
+            }
+          }
+        }
+      },
       "muxVideo": {
         "type": "object",
         "properties": {

package/specs/test/sales.json

@@ -2449,6 +2449,53 @@
         ]
       }
     },
+    "/v1.0/tenders/{id}/slack-messages": {
+      "post": {
+        "tags": [
+          "Tenders"
+        ],
+        "summary": "Queue a Slack message for a tender (Service Bus → notifications-function).",
+        "operationId": "SendTenderSlackMessage",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sendTenderSlackMessageRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "204": {
+            "description": "No description"
+          },
+          "400": {
+            "description": "No description"
+          },
+          "404": {
+            "description": "No description"
+          }
+        },
+        "security": [
+          {
+            "Implicit": [
+              "api://d7f15838-af74-4048-88b3-503089de0064/.default"
+            ]
+          }
+        ]
+      }
+    },
     "/v1.0/tenders/{id}/consultants/{email}": {
       "delete": {
         "tags": [
@@ -3779,6 +3826,19 @@
           }
         }
       },
+      "sendTenderSlackMessageRequest": {
+        "type": "object",
+        "properties": {
+          "channelId": {
+            "type": "string",
+            "nullable": true
+          },
+          "message": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
       "sourceFile": {
         "type": "object",
         "properties": {

package/specs/test/sanity.json

@@ -34406,6 +34406,49 @@
         "type": "object",
         "additionalProperties": true
       },
+      "GetArticleWithDraftResult": {
+        "description": "Snapshot combining the published version and any in-progress\ndraft. Used by the editor UI so authors can see both states and\ndecide when to promote.",
+        "properties": {
+          "publishedId": {
+            "type": "string",
+            "nullable": true,
+            "description": "Canonical published id (no `drafts.` prefix). `null` when the\narticle only exists as a draft (freshly created)."
+          },
+          "published": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+              }
+            ],
+            "nullable": true,
+            "description": "Published article, renamed-field form. `null` if never published."
+          },
+          "draft": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+              }
+            ],
+            "nullable": true,
+            "description": "Draft article (from `drafts.<id>`), renamed-field form. `null`\nwhen the article has no pending draft."
+          },
+          "hasPublished": {
+            "type": "boolean"
+          },
+          "hasDraft": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "publishedId",
+          "published",
+          "draft",
+          "hasPublished",
+          "hasDraft"
+        ],
+        "type": "object",
+        "additionalProperties": true
+      },
       "GetAppByKeyResult": {
         "properties": {
           "menu": {
@@ -50017,6 +50060,210 @@
         ]
       }
     },
+    "/v1.0/articles/{slugOrId}/draft-status": {
+      "get": {
+        "operationId": "GetArticleWithDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticleWithDraftResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Read both states at once. Returns all `null`s if neither exists.\nAccepts a published id or a slug; draft lookup is by id, so we\nresolve slug→id via the published GROQ query first. Brand-new\ndrafts (no published counterpart) can be fetched by passing the\nbare `drafts.<id>` form or the plain `<id>` half — the handler\ntries both.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "slugOrId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ]
+      }
+    },
+    "/v1.0/articles/drafts": {
+      "post": {
+        "operationId": "CreateDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Create a brand-new article as a draft. Returns the created\ndraft document (its `sanityId` carries the `drafts.` prefix).\nAuthors use this from the \"New article\" flow so nothing goes\nlive until they press publish.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityCreateArticle"
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1.0/articles/{slugOrId}/draft": {
+      "patch": {
+        "operationId": "PatchDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Write an edit to the draft for `slugOrId`. If no draft exists\nwe clone the published document first, so partial patches\npreserve existing content. `slugOrId` must resolve to a document\nid — callers coming in via slug should go through blog-function\n(which resolves with GetArticleWithDraft before calling this)\nso the authZ check and slug→id resolution happen together.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "slugOrId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SanityPatchArticle"
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "DiscardDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "allOf": [
+                    {
+                      "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+                    }
+                  ],
+                  "nullable": true
+                }
+              }
+            }
+          }
+        },
+        "description": "Delete the draft for `slugOrId` without touching the published\ndocument. Returns the discarded draft (pre-delete snapshot) or\n`null` if no draft existed.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "slugOrId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ]
+      }
+    },
+    "/v1.0/articles/{slugOrId}/publish": {
+      "post": {
+        "operationId": "PublishDraft",
+        "responses": {
+          "200": {
+            "description": "Ok",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/GetArticlesBySlugOrIdResult"
+                }
+              }
+            }
+          }
+        },
+        "description": "Promote the draft for `slugOrId` to published. Overwrites the\npublished document with the draft's content and deletes the\ndraft. Returns the newly-published document.",
+        "tags": [
+          "Articles"
+        ],
+        "security": [
+          {
+            "Implicit": [
+              "api://5dc55e32-6742-4fe9-b8b6-581cf56af144/.default"
+            ]
+          }
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "slugOrId",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ]
+      }
+    },
     "/v1.0/apps": {
       "get": {
         "operationId": "GetApps",