From 9915ea1cf9e0c4d0b785b913a23756753d73e0a0 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Mon, 10 Aug 2026 11:24:04 +0000
Subject: [PATCH] Document template draft persistence

Templates can now be saved as drafts visible only to their creator.
The create endpoint accepts an optional `publish` flag (defaults to
true) and no longer requires `title` or `data`. The update endpoint
accepts a `publish` flag to make a draft available to other members.
---
 spec3.json | 20 ++++++++++++--------
 spec3.yml  | 15 +++++++++------
 2 files changed, 21 insertions(+), 14 deletions(-)

diff --git a/spec3.json b/spec3.json
index 9cf3b06..f70091d 100644
--- a/spec3.json
+++ b/spec3.json
@@ -8064,7 +8064,7 @@
           "Templates"
         ],
         "summary": "Create a template",
-        "description": "Create a new template that can be used as a starting point for new documents. Templates can optionally be scoped to a specific collection.",
+        "description": "Create a new template that can be used as a starting point for new documents. Templates can optionally be scoped to a specific collection. When `publish` is false the template is saved as a draft visible only to its creator.",
         "requestBody": {
           "content": {
             "application/json": {
@@ -8079,7 +8079,6 @@
                   "title": {
                     "type": "string",
                     "description": "The title of the template.",
-                    "minLength": 1,
                     "maxLength": 255
                   },
                   "data": {
@@ -8101,12 +8100,13 @@
                     "type": "string",
                     "format": "uuid",
                     "description": "Identifier for the collection to which the template belongs."
+                  },
+                  "publish": {
+                    "type": "boolean",
+                    "description": "Whether the template is available to other members. Set to false to create a draft visible only to its creator. Defaults to true.",
+                    "default": true
                   }
-                },
-                "required": [
-                  "title",
-                  "data"
-                ]
+                }
               }
             }
           }
@@ -8299,7 +8299,7 @@
           "Templates"
         ],
         "summary": "Update a template",
-        "description": "Update an existing template by its unique identifier.",
+        "description": "Update an existing template by its unique identifier. Draft templates can be made available to other members by passing `publish: true`.",
         "requestBody": {
           "content": {
             "application/json": {
@@ -8338,6 +8338,10 @@
                     "format": "uuid",
                     "description": "Identifier for the collection to which the template belongs. Set to null for a workspace-wide template.",
                     "nullable": true
+                  },
+                  "publish": {
+                    "type": "boolean",
+                    "description": "Whether to make a draft template available to other members."
                   }
                 },
                 "required": [
diff --git a/spec3.yml b/spec3.yml
index e2a8109..a6470f2 100644
--- a/spec3.yml
+++ b/spec3.yml
@@ -5590,7 +5590,7 @@ paths:
       tags:
         - Templates
       summary: Create a template
-      description: Create a new template that can be used as a starting point for new documents. Templates can optionally be scoped to a specific collection.
+      description: Create a new template that can be used as a starting point for new documents. Templates can optionally be scoped to a specific collection. When `publish` is false the template is saved as a draft visible only to its creator.
       requestBody:
         content:
           application/json:
@@ -5604,7 +5604,6 @@ paths:
                 title:
                   type: string
                   description: The title of the template.
-                  minLength: 1
                   maxLength: 255
                 data:
                   type: object
@@ -5622,9 +5621,10 @@ paths:
                   type: string
                   format: uuid
                   description: Identifier for the collection to which the template belongs.
-              required:
-                - title
-                - data
+                publish:
+                  type: boolean
+                  description: Whether the template is available to other members. Set to false to create a draft visible only to its creator. Defaults to true.
+                  default: true
       responses:
         "200":
           description: OK
@@ -5742,7 +5742,7 @@ paths:
       tags:
         - Templates
       summary: Update a template
-      description: Update an existing template by its unique identifier.
+      description: "Update an existing template by its unique identifier. Draft templates can be made available to other members by passing `publish: true`."
       requestBody:
         content:
           application/json:
@@ -5775,6 +5775,9 @@ paths:
                   format: uuid
                   description: Identifier for the collection to which the template belongs. Set to null for a workspace-wide template.
                   nullable: true
+                publish:
+                  type: boolean
+                  description: Whether to make a draft template available to other members.
               required:
                 - id
       responses: