From 7347deacb01a0fae61a6eeabb7998ed56100dcaa Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Mon, 27 Apr 2026 11:12:35 +0000
Subject: [PATCH] Document per-share branding fields on /shares.update and
 Share schema

Adds the new title and iconUrl fields introduced in outline/outline#12003,
which let an individual share override the workspace branding on its
publicly shared page.

https://claude.ai/code/session_01ReQAPadYsrgjFpgobBmRRG
---
 spec3.json | 22 ++++++++++++++++++++++
 spec3.yml  | 26 ++++++++++++++++++++++++++
 2 files changed, 48 insertions(+)

diff --git a/spec3.json b/spec3.json
index fbe5211..bad2e00 100644
--- a/spec3.json
+++ b/spec3.json
@@ -6594,6 +6594,18 @@
                   },
                   "published": {
                     "type": "boolean"
+                  },
+                  "title": {
+                    "type": "string",
+                    "maxLength": 255,
+                    "nullable": true,
+                    "description": "Override title displayed on the publicly shared page. If not set the source document or collection title is used."
+                  },
+                  "iconUrl": {
+                    "type": "string",
+                    "maxLength": 4096,
+                    "nullable": true,
+                    "description": "URL of an icon to display on the publicly shared page, overriding the workspace branding."
                   }
                 },
                 "required": [
@@ -9039,6 +9051,16 @@
             "description": "URL of the publicly shared document.",
             "readOnly": true
           },
+          "title": {
+            "type": "string",
+            "nullable": true,
+            "description": "Override title displayed on the publicly shared page. If not set the source document or collection title is used."
+          },
+          "iconUrl": {
+            "type": "string",
+            "nullable": true,
+            "description": "URL of an icon displayed on the publicly shared page, overriding the workspace branding."
+          },
           "published": {
             "type": "boolean",
             "example": false,
diff --git a/spec3.yml b/spec3.yml
index 3221ce0..9bfa32a 100644
--- a/spec3.yml
+++ b/spec3.yml
@@ -4582,6 +4582,20 @@ paths:
                   format: uuid
                 published:
                   type: boolean
+                title:
+                  type: string
+                  maxLength: 255
+                  nullable: true
+                  description:
+                    Override title displayed on the publicly shared page. If
+                    not set the source document or collection title is used.
+                iconUrl:
+                  type: string
+                  maxLength: 4096
+                  nullable: true
+                  description:
+                    URL of an icon to display on the publicly shared page,
+                    overriding the workspace branding.
               required:
                 - id
                 - published
@@ -6275,6 +6289,18 @@ components:
           format: uri
           description: URL of the publicly shared document.
           readOnly: true
+        title:
+          type: string
+          nullable: true
+          description:
+            Override title displayed on the publicly shared page. If not set
+            the source document or collection title is used.
+        iconUrl:
+          type: string
+          nullable: true
+          description:
+            URL of an icon displayed on the publicly shared page, overriding
+            the workspace branding.
         published:
           type: boolean
           example: false