aspera-cli 4.27.2 → 4.27.4

data/lib/aspera/schema/IBM Aspera on Cloud API-0.2.6-enhanced.yaml

@@ -754,6 +754,10 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - App Memberships
   /apps/app_memberships/{id}:
@@ -788,6 +792,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - App Memberships
     get:
@@ -825,6 +833,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - App Memberships
   /apps/{aspera_app_type}/app_memberships:
@@ -878,6 +890,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - App Memberships
     get:
@@ -949,6 +965,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - App Memberships
   /apps/{aspera_app_type}/app_memberships/{id}:
@@ -998,6 +1018,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - App Memberships
     put:
@@ -1049,6 +1073,10 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedError'
         '403':
           description: Forbidden
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ForbiddenError'
         '404':
           description: Not Found
           content:
@@ -1059,6 +1087,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - App Memberships
   /client_access_keys:
@@ -1106,6 +1138,10 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Client Access Keys
     post:
@@ -1139,6 +1175,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Client Access Keys
   /client_access_keys/{id}:
@@ -1172,6 +1212,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Client Access Keys
     get:
@@ -1209,6 +1253,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Client Access Keys
     put:
@@ -1257,6 +1305,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Client Access Keys
   /client_authorizations:
@@ -1314,6 +1366,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Client Authorizations
     post:
@@ -1353,6 +1409,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Client Authorizations
   /client_authorizations/{id}:
@@ -1390,6 +1450,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Client Authorizations
     get:
@@ -1435,6 +1499,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Client Authorizations
   /clients:
@@ -1471,6 +1539,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Clients
     post:
@@ -1506,6 +1578,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Clients
   /clients/{id}:
@@ -1543,6 +1619,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Clients
     get:
@@ -1583,6 +1663,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Clients
     put:
@@ -1625,6 +1709,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Clients
   /dropbox_memberships:
@@ -1753,6 +1841,10 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Dropbox Memberships
     post:
@@ -1786,6 +1878,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Dropbox Memberships
   /dropbox_memberships/{id}:
@@ -1821,6 +1917,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Dropbox Memberships
     get:
@@ -1863,6 +1963,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Dropbox Memberships
     put:
@@ -1899,6 +2003,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Dropbox Memberships
   /dropboxes:
@@ -1954,6 +2062,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Dropboxes
     post:
@@ -1989,6 +2101,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Dropboxes
   /dropboxes/{id}:
@@ -2024,6 +2140,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Dropboxes
     get:
@@ -2060,6 +2180,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Dropboxes
     put:
@@ -2102,6 +2226,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Dropboxes
   /nodes:
@@ -2164,6 +2292,10 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Nodes
     post:
@@ -2193,6 +2325,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Nodes
   /nodes/{id}:
@@ -2222,6 +2358,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Nodes
     get:
@@ -2258,6 +2398,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Nodes
     put:
@@ -2294,6 +2438,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Nodes
   /nodes/{id}/update_status:
@@ -2331,6 +2479,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Nodes
   /organizations/{id}:
@@ -2368,6 +2520,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Organizations
     put:
@@ -2399,6 +2555,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Organizations
   /packages:
@@ -2579,6 +2739,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Packages
     post:
@@ -2614,6 +2778,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Packages
   /packages/{id}:
@@ -2654,6 +2822,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Packages
     get:
@@ -2699,6 +2871,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Packages
     put:
@@ -2744,6 +2920,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Packages
   /usage_reports:
@@ -2793,6 +2973,10 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Usage Reports
   /users:
@@ -2883,6 +3067,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Users
     post:
@@ -2918,6 +3106,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Users
   /users/{id}:
@@ -2955,6 +3147,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Users
     get:
@@ -3000,6 +3196,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Users
     put:
@@ -3042,6 +3242,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Users
   /users/{id}/user_interaction_preferences:
@@ -3073,6 +3277,10 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedError'
         '403':
           description: Forbidden - User can only access their own preferences unless they are an organization admin
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ForbiddenError'
         '404':
           description: Not Found
           content:
@@ -3081,6 +3289,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Users
     put:
@@ -3114,6 +3326,10 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedError'
         '403':
           description: Forbidden - User can only update their own preferences unless they are an organization admin
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ForbiddenError'
         '404':
           description: Not Found
           content:
@@ -3124,6 +3340,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Users
   /workspace_memberships:
@@ -3188,6 +3408,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Workspace Memberships
     post:
@@ -3227,6 +3451,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Workspace Memberships
   /workspace_memberships/{id}:
@@ -3266,6 +3494,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Workspace Memberships
     get:
@@ -3313,6 +3545,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Workspace Memberships
     put:
@@ -3355,6 +3591,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Workspace Memberships
   /workspaces:
@@ -3424,6 +3664,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Workspaces
     post:
@@ -3459,6 +3703,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Workspaces
   /workspaces/{id}:
@@ -3570,6 +3818,13 @@ paths:
                   - $ref: '#/components/schemas/app_settings_packages'
                   - $ref: '#/components/schemas/app_settings_activity'
                   - $ref: '#/components/schemas/app_settings_automation'
+                discriminator:
+                  propertyName: app_type
+                  mapping:
+                    files: '#/components/schemas/app_settings_files'
+                    packages: '#/components/schemas/app_settings_packages'
+                    activity: '#/components/schemas/app_settings_activity'
+                    automation: '#/components/schemas/app_settings_automation'
               examples:
                 files:
                   summary: Files application settings
@@ -3652,7 +3907,7 @@ paths:
         content:
           application/json:
             schema:
-              oneOf:
+              anyOf:
                 - $ref: '#/components/schemas/app_settings_files_update'
                 - $ref: '#/components/schemas/app_settings_packages_update'
                 - $ref: '#/components/schemas/app_settings_activity_update'
@@ -3680,6 +3935,13 @@ paths:
                   - $ref: '#/components/schemas/app_settings_packages'
                   - $ref: '#/components/schemas/app_settings_activity'
                   - $ref: '#/components/schemas/app_settings_automation'
+                discriminator:
+                  propertyName: app_type
+                  mapping:
+                    files: '#/components/schemas/app_settings_files'
+                    packages: '#/components/schemas/app_settings_packages'
+                    activity: '#/components/schemas/app_settings_activity'
+                    automation: '#/components/schemas/app_settings_automation'
         '204':
           description: No Content
         '400':
@@ -4643,6 +4905,20 @@ paths:
                 type: array
                 items:
                   $ref: '#/components/schemas/feature_flags_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Feature Flags
     post:
@@ -4663,6 +4939,20 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/feature_flags_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Feature Flags
   /feature_flags/{id}:
@@ -4684,6 +4974,26 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/feature_flags_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotFoundError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Feature Flags
     put:
@@ -4711,6 +5021,26 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/feature_flags_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotFoundError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Feature Flags
     delete:
@@ -4727,16 +5057,50 @@ paths:
       responses:
         '204':
           description: No Content
-      tags:
-        - Feature Flags
-  /file_upload_notifications:
-    get:
-      operationId: get_file_upload_notifications
-      summary: Get File Upload Notifications
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotFoundError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
+      tags:
+        - Feature Flags
+  /file_upload_notifications:
+    get:
+      operationId: get_file_upload_notifications
+      summary: Get File Upload Notifications
       description: List file upload notifications for the current user.
       responses:
         '200':
           description: OK
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - File Upload Notifications
     post:
@@ -4753,6 +5117,20 @@ paths:
       responses:
         '201':
           description: Created
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - File Upload Notifications
   /file_upload_notifications/{id}:
@@ -4779,6 +5157,26 @@ paths:
           description: OK
         '204':
           description: No Content
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotFoundError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - File Upload Notifications
     delete:
@@ -4795,6 +5193,26 @@ paths:
       responses:
         '204':
           description: No Content
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotFoundError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - File Upload Notifications
   /file_upload_notifications/get_toggle_state:
@@ -4817,6 +5235,26 @@ paths:
       responses:
         '200':
           description: OK
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '403':
+          description: Forbidden. Also returned when neither `node_id` nor `file_id` is provided.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ForbiddenError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - File Upload Notifications
   /operations:
@@ -4876,6 +5314,20 @@ paths:
                 type: array
                 items:
                   $ref: '#/components/schemas/operations_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Operations
   /operations/{id}:
@@ -4897,6 +5349,26 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/operations_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotFoundError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Operations
     put:
@@ -4942,6 +5414,20 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/organizations_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Organizations
     put:
@@ -4963,6 +5449,20 @@ paths:
                 $ref: '#/components/schemas/organizations_response'
         '204':
           description: No Content
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Organizations
   /packages_count:
@@ -4979,6 +5479,20 @@ paths:
                 type: integer
                 description: Total number of packages visible to the current caller.
                 example: 6982
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Packages
   /self:
@@ -5000,13 +5514,73 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/users_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Self
   /short_links:
     get:
       operationId: get_short_links
       summary: Get Short Links
-      description: List short links visible to the current caller.
+      description: List short links of a shared resource (shared folder or shared inbox) visible to the current caller.
+      parameters:
+        - name: json_query
+          in: query
+          description: >-
+            JSON-encoded shared resource of the links. Public link: `{"url_token_data":{"data":<resource>,"purpose":<token purpose>}}`
+            (see `short_link_url_token_data`). Private link: `{"node_id":..,"file_id":..,"workspace_id":..}`
+          schema:
+            type: string
+        - name: purpose
+          in: query
+          description: Purpose of the short links (see `short_link_purpose`)
+          schema:
+            type: string
+            enum:
+              - token_auth_redirection
+              - shared_folder_auth_link
+        - name: edit_access
+          in: query
+          description: Check edit access on the shared folder given by `node_id` and `file_id` in `json_query` (shared folder links only, rejected for shared inbox links)
+          schema:
+            type: boolean
+        - name: admin
+          in: query
+          description: Act as organization administrator (sent by the web UI for an administrator)
+          schema:
+            type: boolean
+        - name: embed
+          in: query
+          description: Embed related resources (e.g. `updated_by_user`)
+          schema:
+            type: string
+        - name: sort
+          in: query
+          description: Sort order (e.g. `-created_at`)
+          schema:
+            type: string
+        - name: page
+          in: query
+          description: Page number
+          schema:
+            type: integer
+        - name: per_page
+          in: query
+          description: Number of items per page
+          schema:
+            type: integer
       responses:
         '200':
           description: OK
@@ -5016,19 +5590,38 @@ paths:
                 type: array
                 items:
                   $ref: '#/components/schemas/short_links_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Short Links
     post:
       operationId: add_short_link
       summary: Create a Short Link
-      description: Create a short link.
+      description: Create a short link to a shared folder or a shared inbox.
+      parameters:
+        - name: admin
+          in: query
+          description: Act as organization administrator (sent by the web UI for an administrator)
+          schema:
+            type: boolean
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              type: object
-              additionalProperties: true
+              $ref: '#/components/schemas/short_link_create_params'
       responses:
         '201':
           description: Created
@@ -5036,13 +5629,27 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/short_links_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Short Links
   /short_links/{id}:
     put:
       operationId: update_short_link
       summary: Update a Short Link
-      description: Update a short link.
+      description: Update a short link (expiration, password).
       parameters:
         - name: id
           in: path
@@ -5050,13 +5657,17 @@ paths:
           schema:
             type: string
           description: Unique identifier of the resource.
+        - name: admin
+          in: query
+          description: Act as organization administrator (sent by the web UI for an administrator)
+          schema:
+            type: boolean
       requestBody:
         required: true
         content:
           application/json:
             schema:
-              type: object
-              additionalProperties: true
+              $ref: '#/components/schemas/short_link_update_params'
       responses:
         '200':
           description: OK
@@ -5064,6 +5675,26 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/short_links_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotFoundError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Short Links
     delete:
@@ -5077,9 +5708,44 @@ paths:
           schema:
             type: string
           description: Unique identifier of the resource.
+        - name: json_query
+          in: query
+          description: JSON-encoded shared folder of the link, with `edit_access` (shared folder links only)
+          schema:
+            type: string
+        - name: edit_access
+          in: query
+          description: Check edit access on the shared folder given by `node_id` and `file_id` in `json_query` (shared folder links only, rejected for shared inbox links)
+          schema:
+            type: boolean
+        - name: admin
+          in: query
+          description: Act as organization administrator (sent by the web UI for an administrator)
+          schema:
+            type: boolean
       responses:
         '204':
           description: No Content
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotFoundError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Short Links
   /tier_restrictions:
@@ -5154,6 +5820,20 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/transfer_report_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Transfer Analytics
   /transfers:
@@ -5170,6 +5850,20 @@ paths:
                 type: array
                 items:
                   $ref: '#/components/schemas/transfers_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Transfers
     delete:
@@ -5179,6 +5873,20 @@ paths:
       responses:
         '204':
           description: No Content
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Transfers
   /transfers/{id}:
@@ -5200,6 +5908,26 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/transfers_response'
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotFoundError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Transfers
     delete:
@@ -5216,6 +5944,26 @@ paths:
       responses:
         '204':
           description: No Content
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotFoundError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Transfers
   /workspace_collaborators:
@@ -5226,6 +5974,20 @@ paths:
       responses:
         '200':
           description: OK
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Workspace Collaborators
     post:
@@ -5242,6 +6004,20 @@ paths:
       responses:
         '201':
           description: Created
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Workspace Collaborators
   /workspace_collaborators/{id}:
@@ -5259,6 +6035,26 @@ paths:
       responses:
         '200':
           description: OK
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotFoundError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Workspace Collaborators
     delete:
@@ -5275,6 +6071,26 @@ paths:
       responses:
         '204':
           description: No Content
+        '400':
+          description: Bad Request
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedError'
+        '404':
+          description: Not Found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/NotFoundError'
+        '500':
+          description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Workspace Collaborators
   /contacts:
@@ -5401,6 +6217,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Contacts
     post:
@@ -5477,6 +6297,10 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedError'
         '403':
           description: Forbidden
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ForbiddenError'
         '404':
           description: Not Found
           content:
@@ -5491,6 +6315,10 @@ paths:
                 $ref: '#/components/schemas/ValidationError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Contacts
         - Contacts
@@ -5516,6 +6344,10 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Configuration Policies
     post:
@@ -5547,6 +6379,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Configuration Policies
   /configuration_policies/{id}:
@@ -5578,6 +6414,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Configuration Policies
     get:
@@ -5612,6 +6452,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Configuration Policies
     put:
@@ -5656,6 +6500,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Configuration Policies
   /network_policies:
@@ -5680,6 +6528,10 @@ paths:
                 $ref: '#/components/schemas/UnauthorizedError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Network Policies
     post:
@@ -5711,6 +6563,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Network Policies
   /network_policies/{id}:
@@ -5742,6 +6598,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Network Policies
     get:
@@ -5776,6 +6636,10 @@ paths:
                 $ref: '#/components/schemas/NotFoundError'
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Network Policies
     put:
@@ -5820,6 +6684,10 @@ paths:
           description: Unprocessable Entity
         '500':
           description: Internal Server Error
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerError'
       tags:
         - Network Policies
 components:
@@ -5862,8 +6730,9 @@ components:
           description: Human-readable error description providing additional context about the error
           example: invalid URL token
         state:
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           description: >-
             State parameter from the authorization request, if present. Used to maintain state between request and
             callback.
@@ -5949,6 +6818,62 @@ components:
         code: not_found
         message: The resource you were looking for does not exist
         request_id: 58825f7f-42bb-4f4e-90bc-a6deb9b999db
+    ForbiddenError:
+      type: object
+      description: |
+        Standard error response for 403 Forbidden.
+      properties:
+        code:
+          type: string
+          description: Error code identifying the type of error
+          enum:
+            - forbidden
+          example: forbidden
+        message:
+          type: string
+          description: Human-readable error message
+          example: "You are not authorized to perform the requested action"
+        request_id:
+          type: string
+          format: uuid
+          description: Unique identifier for the request, useful for debugging and support
+          example: 4387db5b-d84b-43f8-b5c1-0d9d878714d6
+      required:
+        - code
+        - message
+        - request_id
+      example:
+        code: forbidden
+        message: "You are not authorized to perform the requested action"
+        request_id: 4387db5b-d84b-43f8-b5c1-0d9d878714d6
+    InternalServerError:
+      type: object
+      description: |
+        Standard error response for 500 Internal Server Error.
+      properties:
+        code:
+          type: string
+          description: Error code identifying the type of error
+          enum:
+            - internal_server_error
+          example: internal_server_error
+        message:
+          type: string
+          description: Human-readable error message
+          example: "We're sorry, but something went wrong. We've been notified about this issue and we'll take a look at it shortly."
+        request_id:
+          type: string
+          format: uuid
+          description: Unique identifier for the request, useful for debugging and support
+          example: 17a835e7-17d0-40f9-8ac3-ff23a45d461e
+      required:
+        - code
+        - message
+        - request_id
+      example:
+        code: internal_server_error
+        message: "We're sorry, but something went wrong. We've been notified about this issue and we'll take a look at it shortly."
+        request_id: 17a835e7-17d0-40f9-8ac3-ff23a45d461e
     ClientRegistrationToken:
       type: object
       description: Client registration token with metadata
@@ -6509,7 +7434,7 @@ components:
             app_name:
               example: Files
             app_type:
-              example: files
+              const: files
         - $ref: '#/components/schemas/app_settings_base'
         - $ref: '#/components/schemas/app_settings_files_specific'
       description: Complete settings for the Files application (includes read-only fields)
@@ -6521,7 +7446,7 @@ components:
             app_name:
               example: Packages
             app_type:
-              example: packages
+              const: packages
         - $ref: '#/components/schemas/app_settings_base'
         - $ref: '#/components/schemas/app_settings_packages_specific'
       description: Complete settings for the Packages application (includes read-only fields)
@@ -6533,7 +7458,7 @@ components:
             app_name:
               example: Activity
             app_type:
-              example: activity
+              const: activity
         - $ref: '#/components/schemas/app_settings_base'
       description: Complete settings for the Activity application (includes read-only fields)
     app_settings_automation:
@@ -6544,7 +7469,7 @@ components:
             app_name:
               example: Automation
             app_type:
-              example: automation
+              const: automation
         - $ref: '#/components/schemas/app_settings_base'
       description: Complete settings for the Automation application (includes read-only fields)
     app_memberships_params:
@@ -6781,6 +7706,9 @@ components:
             - packages
             - activity
             - automation
+      required:
+        - app_name
+        - app_type
     client_access_keys_params:
       type: object
       properties:
@@ -7491,7 +8419,9 @@ components:
             this parameter, draft package contents are deleted. If this parameter is null, it defaults to the workspace
             setting. To set a time-based expiration policy for non-draft packages, see content_retention_duration.
             Units: seconds. POST: Admin or Manager permission required. PUT: Admin or Manager permission required.
-          type: integer
+          type:
+            - integer
+            - 'null'
           examples:
             - null
         dropbox_notification_recipients:
@@ -7521,14 +8451,18 @@ components:
           description: >
             Amount of time in seconds it takes for packages in this shared inbox to be deleted once their transfers
             complete. If null, packages will not be deleted on a timer. Read-only.
-          type: integer
+          type:
+            - integer
+            - 'null'
           examples:
             - null
         effective_delete_package_content_after_download_duration:
           description: >
             Amount of time in seconds it takes a package in this shared inbox to be deleted once all recipients have
             downloaded the entire package. If null, packages will not be deleted on a timer. Read-only.
-          type: integer
+          type:
+            - integer
+            - 'null'
           examples:
             - null
         email_notification_settings:
@@ -7915,7 +8849,9 @@ components:
         ats_storage_type:
           description: |
             For Aspera Transfer Service nodes, this field defines which type of storage is used.
-          type: string
+          type:
+            - string
+            - 'null'
           examples:
             - null
           enum:
@@ -7926,6 +8862,7 @@ components:
             - google-gcs
             - ibm-s3
             - softlayer_swift
+            - null
         capabilities:
           type: array
           items:
@@ -8002,7 +8939,9 @@ components:
         ssh_fingerprint:
           description: |
             If your node has SSH capabilities, used for verifying SSH connections.
-          type: string
+          type:
+            - string
+            - 'null'
           examples:
             - null
         status:
@@ -8593,8 +9532,9 @@ components:
           examples:
             - false
         bcc_recipients:
-          type: array
-          nullable: true
+          type:
+            - array
+            - 'null'
           items:
             $ref: '#/components/schemas/senders_recipients_object'
         content_retention_duration:
@@ -8615,8 +9555,9 @@ components:
           examples:
             - 604800
         download_notification_recipients:
-          type: array
-          nullable: true
+          type:
+            - array
+            - 'null'
           items:
             $ref: '#/components/schemas/senders_recipients_object'
         draft:
@@ -8662,7 +9603,6 @@ components:
             - false
         recipients:
           type: array
-          nullable: false
           items:
             $ref: '#/components/schemas/senders_recipients_object'
         sent:
@@ -8693,7 +9633,6 @@ components:
             - 3
         upload_notification_recipients:
           type: array
-          nullable: false
           items:
             $ref: '#/components/schemas/senders_recipients_object'
         workspace_id:
@@ -8729,7 +9668,6 @@ components:
             - true
         bcc_recipients:
           type: array
-          nullable: false
           items:
             $ref: '#/components/schemas/senders_recipients_object'
         bytes_transferred:
@@ -8765,7 +9703,9 @@ components:
             When a time-based content expiration value is set for this package, the duration to retain packages
             contents. When this duration passes, the packages contents are deleted. Valid values are null - 10 years.
             Units are seconds.
-          type: integer
+          type:
+            - integer
+            - 'null'
           examples:
             - null
         contents_file_id:
@@ -8792,7 +9732,9 @@ components:
             which the package contents will be retained even after all recipients have downloaded the package. The timer
             for this setting begins when all recipients have downloaded the package; when the timer expires, the package
             contents are deleted. Valid values are null - 10 years. Units are seconds.
-          type: integer
+          type:
+            - integer
+            - 'null'
           examples:
             - null
         deleted:
@@ -9174,14 +10116,13 @@ components:
           type: boolean
           description: Whether the short link has expired.
         expires_at:
-          type: string
+          type:
+            - string
+            - 'null'
           format: date-time
-          nullable: true
           description: Expiry date-time, or null if the link does not expire.
         data:
-          type: object
-          description: Arbitrary metadata associated with the short link.
-          additionalProperties: true
+          $ref: '#/components/schemas/short_link_data'
         updated_by_user_id:
           type: string
           description: ID of the user who last updated the short link.
@@ -9193,6 +10134,115 @@ components:
           type: string
           format: date-time
           description: Time at which the short link was last updated.
+    short_link_purpose:
+      type: string
+      description: >-
+        Purpose of a short link: `token_auth_redirection` for a public link (URL token, shared folder or shared inbox),
+        `shared_folder_auth_link` for a private link (authentication required, shared folder only)
+      enum:
+        - token_auth_redirection
+        - shared_folder_auth_link
+    short_link_url_token_data:
+      type: object
+      description: URL token of a public short link
+      properties:
+        data:
+          type: object
+          description: >-
+            Shared resource: shared inbox (`dropbox_id`, `name`) or shared folder (`node_id`, `file_id`), and `workspace_id`
+          properties:
+            workspace_id:
+              type: string
+              description: Workspace of the shared resource
+            dropbox_id:
+              type: string
+              description: Shared inbox (token purpose `send_package_to_dropbox`)
+            name:
+              type: string
+              description: Empty string for a shared inbox
+            node_id:
+              type: string
+              description: Node of the shared folder (token purpose `view_shared_file`)
+            file_id:
+              type: string
+              description: File identifier of the shared folder on the node
+          additionalProperties: true
+        purpose:
+          type: string
+          description: Purpose of the URL token, depends on the shared resource
+          enum:
+            - send_package_to_dropbox
+            - view_shared_file
+        password:
+          type: string
+          description: Password to follow the link (write only, with `password_enabled`)
+        expires_at:
+          type:
+            - string
+            - 'null'
+          format: date-time
+          description: Expiry date-time of the URL token
+    short_link_data:
+      type: object
+      description: >-
+        Public link (purpose `token_auth_redirection`): `aoc` and `url_token_data`.
+        Private link (purpose `shared_folder_auth_link`): the shared folder (`node_id`, `file_id`, `workspace_id`)
+      properties:
+        aoc:
+          type: boolean
+          description: Link to an Aspera on Cloud resource (public link)
+        url_token_data:
+          $ref: '#/components/schemas/short_link_url_token_data'
+      additionalProperties: true
+    short_link_create_params:
+      type: object
+      description: Short link creation
+      required:
+        - purpose
+        - data
+      properties:
+        purpose:
+          $ref: '#/components/schemas/short_link_purpose'
+        data:
+          $ref: '#/components/schemas/short_link_data'
+        password_enabled:
+          type: boolean
+          description: Password required to follow the link (password in `data.url_token_data.password`)
+        expires_at:
+          type:
+            - string
+            - 'null'
+          format: date-time
+          description: Expiry date-time, or null if the link does not expire
+        user_selected_name:
+          type:
+            - string
+            - 'null'
+          description: Name of the link chosen by the user
+    short_link_update_params:
+      type: object
+      description: >-
+        Short link modification. Shared inbox link: `data.url_token_data.data` is `{"dropbox_id":..}`.
+        Shared folder link: also `edit_access` and `json_query`
+      properties:
+        password_enabled:
+          type: boolean
+          description: Password required to follow the link (password in `data.url_token_data.password`)
+        expires_at:
+          type:
+            - string
+            - 'null'
+          format: date-time
+          description: Expiry date-time, or null if the link does not expire
+        data:
+          $ref: '#/components/schemas/short_link_data'
+        edit_access:
+          type: boolean
+          description: Check edit access on the shared folder given in `json_query` (shared folder links only)
+        json_query:
+          type: object
+          description: Shared folder of the link (`node_id`, `file_id`), with `edit_access`
+          additionalProperties: true
     transfer_report_response:
       type: object
       description: >
@@ -9280,8 +10330,9 @@ components:
           type: boolean
           description: Whether Trend Micro antivirus scanning is enabled.
         user_limit:
-          type: integer
-          nullable: true
+          type:
+            - integer
+            - 'null'
           description: Maximum number of users allowed. Null means unlimited.
         watermarking_enabled:
           type: boolean
@@ -9552,33 +10603,39 @@ components:
       properties:
         autofill_shared_inbox_sending:
           description: Whether to automatically fill the shared inbox when sending packages
-          type: boolean
-          nullable: true
+          type:
+            - boolean
+            - 'null'
           example: true
         default_aoc_app:
           description: The default Aspera on Cloud application to display on login (e.g., "packages", "files", "activity")
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: packages
         default_language:
           description: The user's preferred language for the UI (e.g., "en-us", "fr-fr", "de-de")
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: en-us
         first_connect_transfer:
           description: Whether this is the user's first time connecting for a transfer (used for onboarding)
-          type: boolean
-          nullable: true
+          type:
+            - boolean
+            - 'null'
           example: true
         first_connect_download:
           description: Whether this is the user's first time connecting for a download (used for onboarding)
-          type: boolean
-          nullable: true
+          type:
+            - boolean
+            - 'null'
           example: true
         pinned_dropbox_ids:
           description: Array of dropbox IDs that the user has pinned for quick access
-          type: array
-          nullable: true
+          type:
+            - array
+            - 'null'
           items:
             type: integer
           example:
@@ -9587,8 +10644,9 @@ components:
             - 3
         pinned_workspace_ids:
           description: Array of workspace IDs that the user has pinned for quick access
-          type: array
-          nullable: true
+          type:
+            - array
+            - 'null'
           items:
             type: integer
           example:
@@ -9596,34 +10654,40 @@ components:
             - 20
         auto_workflow_view:
           description: The default view mode for automation workflows
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: ''
         grid_view_workspaces:
           description: The view mode for workspaces display (e.g., "list", "grid")
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: list
         last_read_coming_soon:
           description: Timestamp of the last time the user viewed the "Coming Soon" announcements
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: 03/19/2021_1
         last_read_whats_new:
           description: Timestamp of the last time the user viewed the "What's New" announcements
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: 03/30/2021_1
         recent_transfers:
           description: Object storing information about recent transfers for quick access
-          type: object
-          nullable: true
+          type:
+            - object
+            - 'null'
           additionalProperties: true
           example: {}
         help_recent:
           description: Array of recently accessed help topics for quick reference
-          type: array
-          nullable: true
+          type:
+            - array
+            - 'null'
           items:
             type: string
           example:
@@ -9631,8 +10695,9 @@ components:
             - creating_a_new_workspace
         tableDataStore:
           description: JSON string containing table configuration and sizing preferences for various UI tables
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: '[{"id":"files-table"},{"id":"user-list","tableSizing":"{\"displayUserStatus\":198}"}]'
       additionalProperties: true
       example:
@@ -9652,73 +10717,86 @@ components:
       properties:
         autofill_shared_inbox_sending:
           description: Whether to automatically fill the shared inbox when sending packages
-          type: boolean
-          nullable: true
+          type:
+            - boolean
+            - 'null'
           example: true
         default_aoc_app:
           description: The default Aspera on Cloud application to display on login
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: packages
         default_language:
           description: The user's preferred language for the UI
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: en-us
         first_connect_transfer:
           description: Whether this is the user's first time connecting for a transfer
-          type: boolean
-          nullable: true
+          type:
+            - boolean
+            - 'null'
           example: null
         first_connect_download:
           description: Whether this is the user's first time connecting for a download
-          type: boolean
-          nullable: true
+          type:
+            - boolean
+            - 'null'
           example: null
         pinned_dropbox_ids:
           description: Array of pinned dropbox IDs
-          type: array
-          nullable: true
+          type:
+            - array
+            - 'null'
           items:
             type: integer
           example: null
         pinned_workspace_ids:
           description: Array of pinned workspace IDs
-          type: array
-          nullable: true
+          type:
+            - array
+            - 'null'
           items:
             type: integer
           example: []
         auto_workflow_view:
           description: Default view mode for automation workflows
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: ''
         grid_view_workspaces:
           description: View mode for workspaces display
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: list
         last_read_coming_soon:
           description: Last viewed "Coming Soon" timestamp
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: 03/19/2021_1
         last_read_whats_new:
           description: Last viewed "What's New" timestamp
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: 03/30/2021_1
         recent_transfers:
           description: Recent transfers information
-          type: object
-          nullable: true
+          type:
+            - object
+            - 'null'
           additionalProperties: true
           example: {}
         help_recent:
           description: Recently accessed help topics
-          type: array
-          nullable: true
+          type:
+            - array
+            - 'null'
           items:
             type: string
           example:
@@ -9727,8 +10805,9 @@ components:
             - attach_azure_blob_storage
         tableDataStore:
           description: Table configuration and sizing preferences (JSON string)
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           example: '[{"id":"files-table"},{"id":"user-list","tableSizing":"{\"displayUserStatus\":198}"}]'
       additionalProperties: true
       example:
@@ -9853,22 +10932,6 @@ components:
           type: integer
           examples:
             - 0
-    workspace_query_params:
-      type: object
-      properties:
-        created_at:
-          type: string
-          format: date-time
-        manager:
-          type: boolean
-        name:
-          description: full text search
-          type: string
-        node_id:
-          type: integer
-        updated_at:
-          type: string
-          format: date-time
     workspaces_params:
       type: object
       properties:
@@ -9921,7 +10984,9 @@ components:
             delete_package_content_after_download_duration. Valid values: null - 10 years. Units: seconds. POST: Admin
             permission required. PUT Manager or Admin permission required. RESPONSE User scope. RESPONSE Admin scope
             (org admin).
-          type: integer
+          type:
+            - integer
+            - 'null'
           examples:
             - null
         default_ear_setting:
@@ -9947,7 +11012,9 @@ components:
             time-based expiration policy, refer to content_retention_duration. Valid values: null - 10 years. Units:
             seconds. POST: Admin permission required. PUT: Manager or Admin permission required. RESPONSE User scope.
             RESPONSE Admin scope (could be ws manager). RESPONSE Admin scope (org admin).
-          type: integer
+          type:
+            - integer
+            - 'null'
           examples:
             - null
         description:
@@ -9965,7 +11032,9 @@ components:
             deleted based on time. To set a time-based expiration policy for non-draft packages in this workspace, refer
             to content_retention_duration. POST: Admin permission required. PUT Manager or Admin permission required.
             RESPONSE User scope. RESPONSE Admin scope (could be ws manager). RESPONSE Admin scope (org admin).
-          type: integer
+          type:
+            - integer
+            - 'null'
           examples:
             - null
         email_footer:
@@ -9973,7 +11042,9 @@ components:
             If 'inherit_email_templates' is set to false, configure the footer for email notifications for this
             workspace. The footer you configure is common to all email notifications for this workspace. POST: Admin
             permission required. PUT: Manager or Admin permission required. RESPONSE Admin scope (org admin).
-          type: string
+          type:
+            - string
+            - 'null'
           examples:
             - null
         email_notification_settings:
@@ -10010,7 +11081,9 @@ components:
             The URI to collect event and activity reports. If this parameter is not null, you can use the
             event_reporting_headers parameter to configure acceptable JSON headers. POST Admin permission required. PUT
             Manager permission required or PUT Admin permission required. RESPONSE Admin scope (org admin).
-          type: string
+          type:
+            - string
+            - 'null'
           examples:
             - null
         external_package_authentication_required:
@@ -10203,7 +11276,9 @@ components:
           description: >-
             The file ID of the root folder containing packages for this workspace. POST Admin permission required. PUT
             Manager permission required or PUT Admin permission required. RESPONSE Admin scope (org admin).
-          type: string
+          type:
+            - string
+            - 'null'
           examples:
             - null
         spool_file_id:
@@ -10294,7 +11369,9 @@ components:
             delete_package_content_after_download_duration. Valid values (null - 10 years) Units (seconds) POST Admin
             permission required. PUT Manager permission required or PUT Admin permission required. RESPONSE User scope.
             RESPONSE Admin scope (org admin).
-          type: integer
+          type:
+            - integer
+            - 'null'
           examples:
             - null
         created_at:
@@ -10326,7 +11403,9 @@ components:
             time-based expiration policy, refer to content_retention_duration. Valid values (null - 10 years) Units
             (seconds) POST Admin permission required. PUT Manager permission required. or PUT Admin permission required.
             RESPONSE User scope. RESPONSE Admin scope (could be ws manager). RESPONSE Admin scope (org admin).
-          type: integer
+          type:
+            - integer
+            - 'null'
           examples:
             - null
         description:
@@ -10345,7 +11424,9 @@ components:
             to content_retention_duration. POST Admin permission required. PUT Manager permission required or PUT Admin
             permission required. RESPONSE User scope. RESPONSE Admin scope (could be ws manager). RESPONSE Admin scope
             (org admin).
-          type: integer
+          type:
+            - integer
+            - 'null'
           examples:
             - null
         effective_default_ear_setting:
@@ -10364,7 +11445,9 @@ components:
             workspace. The footer you configure is common to all email notifications for this workspace. POST Admin
             permission required. PUT Manager permission required or PUT Admin permission required. RESPONSE Admin scope
             (org admin).
-          type: string
+          type:
+            - string
+            - 'null'
           examples:
             - null
         email_notification_settings:
@@ -10403,7 +11486,9 @@ components:
             The URI to collect event and activity reports. If this parameter is not null, you can use the
             event_reporting_headers parameter to configure acceptable JSON headers. POST Admin permission required. PUT
             Manager permission required or PUT Admin permission required. RESPONSE Admin scope (org admin).
-          type: string
+          type:
+            - string
+            - 'null'
           examples:
             - null
         external_package_authentication_required:
@@ -10640,7 +11725,9 @@ components:
           description: >-
             The file ID of the root folder containing packages for this workspace. POST Admin permission required. PUT
             Manager permission required or PUT Admin permission required. RESPONSE Admin scope (org admin).
-          type: string
+          type:
+            - string
+            - 'null'
           examples:
             - null
         spool_file_id:
@@ -10741,9 +11828,10 @@ components:
             - true
         aggressiveness:
           description: Transfer aggressiveness factor (0.0 to 1.0). Null means use node default.
-          type: number
+          type:
+            - number
+            - 'null'
           format: float
-          nullable: true
           examples:
             - 0.15
         cipher:
@@ -10757,14 +11845,16 @@ components:
             - aes-128
         content_protection_secret:
           description: Secret used for content protection (server-side encryption at rest). Null if not set.
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           examples:
             - aspera-1
         default_target_rate_kbps:
           description: Default target transfer rate in kbps. Null means no limit.
-          type: integer
-          nullable: true
+          type:
+            - integer
+            - 'null'
           examples:
             - 150000
         enable_iteration_token_pagination:
@@ -10816,9 +11906,10 @@ components:
             - true
         aggressiveness:
           description: Transfer aggressiveness factor (0.0 to 1.0). Null means use node default.
-          type: number
+          type:
+            - number
+            - 'null'
           format: float
-          nullable: true
           examples:
             - 0.15
         cipher:
@@ -10832,14 +11923,16 @@ components:
             - aes-128
         content_protection_secret:
           description: Secret used for content protection (server-side encryption at rest). Null if not set.
-          type: string
-          nullable: true
+          type:
+            - string
+            - 'null'
           examples:
             - aspera-1
         default_target_rate_kbps:
           description: Default target transfer rate in kbps. Null means no limit.
-          type: integer
-          nullable: true
+          type:
+            - integer
+            - 'null'
           examples:
             - 150000
         enable_iteration_token_pagination: