diff --git a/spec3.json b/spec3.json
index 93562d7..f4579bc 100644
--- a/spec3.json
+++ b/spec3.json
@@ -910,9 +910,13 @@
                   },
                   "description": {
                     "type": "string",
-                    "description": "A brief description of the collection, markdown supported.",
+                    "description": "A brief description of the collection, markdown supported. Only one of `description` or `data` may be provided.",
                     "example": "HR documentation is confidential and should be handled with care."
                   },
+                  "data": {
+                    "type": "object",
+                    "description": "The collection description as a rich-text ProseMirror JSON document. Only one of `description` or `data` may be provided."
+                  },
                   "permission": {
                     "$ref": "#/components/schemas/Permission"
                   },
@@ -999,9 +1003,13 @@
                   },
                   "description": {
                     "type": "string",
-                    "description": "A brief description of the collection, markdown supported.",
+                    "description": "A brief description of the collection, markdown supported. Only one of `description` or `data` may be provided.",
                     "example": "HR documentation is confidential and should be handled with care."
                   },
+                  "data": {
+                    "type": "object",
+                    "description": "The collection description as a rich-text ProseMirror JSON document. Only one of `description` or `data` may be provided."
+                  },
                   "permission": {
                     "$ref": "#/components/schemas/Permission"
                   },
diff --git a/spec3.yml b/spec3.yml
index 82e5c1b..2d35461 100644
--- a/spec3.yml
+++ b/spec3.yml
@@ -808,8 +808,11 @@ paths:
                   example: Human Resources
                 description:
                   type: string
-                  description: A brief description of the collection, markdown supported.
+                  description: A brief description of the collection, markdown supported. Only one of `description` or `data` may be provided.
                   example: HR documentation is confidential and should be handled with care.
+                data:
+                  type: object
+                  description: The collection description as a rich-text ProseMirror JSON document. Only one of `description` or `data` may be provided.
                 permission:
                   "$ref": "#/components/schemas/Permission"
                 icon:
@@ -868,8 +871,11 @@ paths:
                   example: Human Resources
                 description:
                   type: string
-                  description: A brief description of the collection, markdown supported.
+                  description: A brief description of the collection, markdown supported. Only one of `description` or `data` may be provided.
                   example: HR documentation is confidential and should be handled with care.
+                data:
+                  type: object
+                  description: The collection description as a rich-text ProseMirror JSON document. Only one of `description` or `data` may be provided.
                 permission:
                   "$ref": "#/components/schemas/Permission"
                 icon: