diff --git a/src/main/webapp/definitions/alfresco-core.yaml b/src/main/webapp/definitions/alfresco-core.yaml
index f2762f21..4c060892 100755
--- a/src/main/webapp/definitions/alfresco-core.yaml
+++ b/src/main/webapp/definitions/alfresco-core.yaml
@@ -2167,6 +2167,9 @@ paths:
 
             If the content type is not supported for preview, then a value of **false** is ignored, and
             the attachment will be returned in the response.
+
+            The **fileName** field is optional for setting the file name when downloaded. By default Alfresco
+            will use the `cm:name` attribute unless configured otherwise.
           required: false
           schema:
             $ref: '#/definitions/DirectAccessUrlBodyCreate'
@@ -2453,6 +2456,9 @@ paths:
 
             If the content type is not supported for preview, then a value of **false** is ignored, and
             the attachment will be returned in the response.
+
+            The **fileName** field is optional for setting the file name when downloaded. By default Alfresco
+            will use the `cm:name` attribute unless configured otherwise.
           required: false
           schema:
             $ref: '#/definitions/DirectAccessUrlBodyCreate'
@@ -3130,6 +3136,9 @@ paths:
 
             If the content type is not supported for preview, then a value of **false** is ignored, and
             the attachment will be returned in the response.
+
+            The **fileName** field is optional for setting the file name when downloaded. By default Alfresco
+            will use the `cm:name` attribute unless configured otherwise.
           required: false
           schema:
             $ref: '#/definitions/DirectAccessUrlBodyCreate'
@@ -3464,6 +3473,9 @@ paths:
 
             Note: It is up to the actual ContentStore implementation if it can fulfil this
             request or not.
+
+            The **fileName** field is optional for setting the file name when downloaded. By default Alfresco
+            will use the `cm:name` attribute unless configured otherwise.
           required: false
           schema:
             $ref: '#/definitions/DirectAccessUrlBodyCreate'
@@ -4157,6 +4169,9 @@ paths:
 
             If the content type is not supported for preview, then a value of **false** is ignored, and
             the attachment will be returned in the response.
+
+            The **fileName** field is optional for setting the file name when downloaded. By default Alfresco
+            will use the `cm:name` attribute unless configured otherwise.
           required: false
           schema:
             $ref: '#/definitions/DirectAccessUrlBodyCreate'
@@ -4406,6 +4421,9 @@ paths:
 
             If the content type is not supported for preview, then a value of **false** is ignored, and
             the attachment will be returned in the response.
+
+            The **fileName** field is optional for setting the file name when downloaded. By default Alfresco
+            will use the `cm:name` attribute unless configured otherwise.
           required: false
           schema:
             $ref: '#/definitions/DirectAccessUrlBodyCreate'
@@ -10693,6 +10711,9 @@ definitions:
       attachment:
         type: boolean
         description: URL type (embedded/attachment).
+      fileName:
+        type: string
+        description: Optional file name when downloaded
   DirectAccessUrlEntry:
     type: object
     required:
@@ -10715,6 +10736,9 @@ definitions:
         type: string
         format: date-time
         description: The direct access URL would become invalid when the expiry date is reached
+      fileName:
+        type: string
+        description: The file name when downloaded
   SharedLinkBodyCreate:
     type: object
     required: