From 22f1043206578b2fea366242b1516afcc263abb3 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sun, 9 Aug 2026 11:15:35 +0000
Subject: [PATCH] Document draft templates and publish parameter

Reflects the persist-template-drafts changes in outline/outline#13357:
title and data are now optional on /templates.create (required only when
publishing), and both /templates.create and /templates.update accept a
new publish parameter to control whether the template is visible to
other members.

Co-Authored-By: Claude <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015pmLXq3inZ9NWjBfFWhoGt
---
 spec3.json | 20 ++++++++++++--------
 spec3.yml  | 15 +++++++++------
 2 files changed, 21 insertions(+), 14 deletions(-)

diff --git a/spec3.json b/spec3.json
index 9cf3b06..411edfe 100644
--- a/spec3.json
+++ b/spec3.json
@@ -8078,13 +8078,12 @@
                   },
                   "title": {
                     "type": "string",
-                    "description": "The title of the template.",
-                    "minLength": 1,
+                    "description": "The title of the template. Required when publishing.",
                     "maxLength": 255
                   },
                   "data": {
                     "type": "object",
-                    "description": "The body of the template as a Prosemirror document."
+                    "description": "The body of the template as a Prosemirror document. Required when publishing."
                   },
                   "icon": {
                     "type": "string",
@@ -8101,12 +8100,13 @@
                     "type": "string",
                     "format": "uuid",
                     "description": "Identifier for the collection to which the template belongs."
+                  },
+                  "publish": {
+                    "type": "boolean",
+                    "default": true,
+                    "description": "Whether the template is available to other members. Set to false to create a draft that is only visible to its creator."
                   }
-                },
-                "required": [
-                  "title",
-                  "data"
-                ]
+                }
               }
             }
           }
@@ -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": "Set to true to publish a draft template so it becomes available to other members."
                   }
                 },
                 "required": [
diff --git a/spec3.yml b/spec3.yml
index e2a8109..d0ef388 100644
--- a/spec3.yml
+++ b/spec3.yml
@@ -5603,12 +5603,11 @@ paths:
                   description: Optionally provide a specific UUID for the template.
                 title:
                   type: string
-                  description: The title of the template.
-                  minLength: 1
+                  description: The title of the template. Required when publishing.
                   maxLength: 255
                 data:
                   type: object
-                  description: The body of the template as a Prosemirror document.
+                  description: The body of the template as a Prosemirror document. Required when publishing.
                 icon:
                   type: string
                   description: An emoji to use as the template icon.
@@ -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
+                  default: true
+                  description: Whether the template is available to other members. Set to false to create a draft that is only visible to its creator.
       responses:
         "200":
           description: OK
@@ -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: Set to true to publish a draft template so it becomes available to other members.
               required:
                 - id
       responses: