diff --git a/spec3.json b/spec3.json
index 273c380..72bbef5 100644
--- a/spec3.json
+++ b/spec3.json
@@ -6590,7 +6590,7 @@
                   "type": "object",
                   "properties": {
                     "data": {
-                      "$ref": "#/components/schemas/Revision"
+                      "$ref": "#/components/schemas/RevisionDetail"
                     }
                   }
                 }
@@ -6619,7 +6619,7 @@
           "Revisions"
         ],
         "summary": "List all revisions",
-        "description": "List all revisions for a specific document. Revisions represent historical snapshots of a document's content and can be used to track changes over time.",
+        "description": "List all revisions for a specific document. Revisions represent historical snapshots of a document's content and can be used to track changes over time. The `data` and `text` fields are omitted from listed revisions for performance; use `revisions.info` to retrieve the full content of a specific revision.",
         "requestBody": {
           "content": {
             "application/json": {
@@ -9636,16 +9636,6 @@
             "description": "The name of the revision, if any.",
             "readOnly": true
           },
-          "data": {
-            "type": "object",
-            "description": "The body of the revision as a Prosemirror document.",
-            "readOnly": true
-          },
-          "text": {
-            "type": "string",
-            "description": "Body of the document, may contain markdown formatting",
-            "readOnly": true
-          },
           "icon": {
             "type": "string",
             "nullable": true,
@@ -9688,6 +9678,28 @@
           }
         }
       },
+      "RevisionDetail": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/Revision"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "data": {
+                "type": "object",
+                "description": "The body of the revision as a Prosemirror document.",
+                "readOnly": true
+              },
+              "text": {
+                "type": "string",
+                "description": "Body of the document, may contain markdown formatting",
+                "readOnly": true
+              }
+            }
+          }
+        ]
+      },
       "Share": {
         "type": "object",
         "properties": {
diff --git a/spec3.yml b/spec3.yml
index 636f91f..6f2d5fe 100644
--- a/spec3.yml
+++ b/spec3.yml
@@ -4623,7 +4623,7 @@ paths:
                 type: object
                 properties:
                   data:
-                    "$ref": "#/components/schemas/Revision"
+                    "$ref": "#/components/schemas/RevisionDetail"
         "401":
           "$ref": "#/components/responses/Unauthenticated"
         "403":
@@ -4638,7 +4638,7 @@ paths:
       tags:
         - Revisions
       summary: List all revisions
-      description: List all revisions for a specific document. Revisions represent historical snapshots of a document's content and can be used to track changes over time.
+      description: List all revisions for a specific document. Revisions represent historical snapshots of a document's content and can be used to track changes over time. The `data` and `text` fields are omitted from listed revisions for performance; use `revisions.info` to retrieve the full content of a specific revision.
       requestBody:
         content:
           application/json:
@@ -6764,14 +6764,6 @@ components:
           nullable: true
           description: The name of the revision, if any.
           readOnly: true
-        data:
-          type: object
-          description: The body of the revision as a Prosemirror document.
-          readOnly: true
-        text:
-          type: string
-          description: Body of the document, may contain markdown formatting
-          readOnly: true
         icon:
           type: string
           nullable: true
@@ -6804,6 +6796,19 @@ components:
           nullable: true
           description: Date and time when this revision was deleted, if applicable.
           readOnly: true
+    RevisionDetail:
+      allOf:
+        - "$ref": "#/components/schemas/Revision"
+        - type: object
+          properties:
+            data:
+              type: object
+              description: The body of the revision as a Prosemirror document.
+              readOnly: true
+            text:
+              type: string
+              description: Body of the document, may contain markdown formatting
+              readOnly: true
     Share:
       type: object
       properties: