From 57825395e663fc6f51a00d36a6b7d1962bfd2f4f Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 7 Aug 2026 11:20:29 +0000
Subject: [PATCH] Document invitedBy on User and sourceMetadata.authType on
 Revision

Reflects two changes recently merged to outline/outline:

- User responses now include an invitedBy user object (admin-only,
  eager-loaded on users.list).
- Revision responses now include sourceMetadata.authType capturing
  which auth method (api, app, mcp, oauth) created the revision.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01M8M2DkrMHkkH9oAo5kP4dP
---
 spec3.json | 30 ++++++++++++++++++++++++++++++
 spec3.yml  | 23 +++++++++++++++++++++++
 2 files changed, 53 insertions(+)

diff --git a/spec3.json b/spec3.json
index 9cf3b06..2cd5f16 100644
--- a/spec3.json
+++ b/spec3.json
@@ -9764,6 +9764,26 @@
             "nullable": true,
             "description": "Date and time when this revision was deleted, if applicable.",
             "readOnly": true
+          },
+          "sourceMetadata": {
+            "type": "object",
+            "nullable": true,
+            "description": "Metadata about the source of this revision, if any.",
+            "readOnly": true,
+            "properties": {
+              "authType": {
+                "type": "string",
+                "nullable": true,
+                "description": "The authentication method used when this revision was created.",
+                "enum": [
+                  "api",
+                  "app",
+                  "mcp",
+                  "oauth"
+                ],
+                "readOnly": true
+              }
+            }
           }
         }
       },
@@ -10129,6 +10149,16 @@
             "description": "The date and time that this user was deleted, if applicable.",
             "readOnly": true,
             "format": "date-time"
+          },
+          "invitedBy": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/User"
+              }
+            ],
+            "nullable": true,
+            "description": "The user who invited this user, if any. Only returned to admins.",
+            "readOnly": true
           }
         }
       },
diff --git a/spec3.yml b/spec3.yml
index e2a8109..616a859 100644
--- a/spec3.yml
+++ b/spec3.yml
@@ -6864,6 +6864,22 @@ components:
           nullable: true
           description: Date and time when this revision was deleted, if applicable.
           readOnly: true
+        sourceMetadata:
+          type: object
+          nullable: true
+          description: Metadata about the source of this revision, if any.
+          readOnly: true
+          properties:
+            authType:
+              type: string
+              nullable: true
+              description: The authentication method used when this revision was created.
+              enum:
+                - api
+                - app
+                - mcp
+                - oauth
+              readOnly: true
     RevisionDetail:
       allOf:
         - "$ref": "#/components/schemas/Revision"
@@ -7190,6 +7206,13 @@ components:
           description: The date and time that this user was deleted, if applicable.
           readOnly: true
           format: date-time
+        invitedBy:
+          allOf:
+            - "$ref": "#/components/schemas/User"
+          nullable: true
+          description:
+            The user who invited this user, if any. Only returned to admins.
+          readOnly: true
     Invite:
       type: object
       properties: