RubyGems - aspera-cli - Versions diffs - 4.27.0 → 4.27.2 - Mend

aspera-cli 4.27.0 → 4.27.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (142) hide show

checksums.yaml +4 -4
checksums.yaml.gz.sig +0 -0
data/CHANGELOG.md +46 -1
data/CONTRIBUTING.md +1 -7
data/TODO.md +50 -0
data/docs/README.md +709 -489
data/lib/aspera/agent/base.rb +10 -2
data/lib/aspera/agent/connect.rb +7 -7
data/lib/aspera/agent/desktop.rb +3 -3
data/lib/aspera/agent/direct.rb +48 -19
data/lib/aspera/agent/factory.rb +3 -3
data/lib/aspera/agent/httpgw.rb +55 -14
data/lib/aspera/agent/node.rb +2 -2
data/lib/aspera/agent/transferd.rb +12 -12
data/lib/aspera/api/aoc.rb +28 -28
data/lib/aspera/api/cos_node.rb +10 -9
data/lib/aspera/api/faspex.rb +2 -2
data/lib/aspera/api/httpgw.rb +20 -20
data/lib/aspera/api/node.rb +31 -53
data/lib/aspera/ascmd.rb +13 -13
data/lib/aspera/ascp/installation.rb +43 -36
data/lib/aspera/ascp/management.rb +6 -6
data/lib/aspera/assert.rb +12 -13
data/lib/aspera/cli/ascp_actions.rb +7 -7
data/lib/aspera/cli/async_transfer_store.rb +49 -5
data/lib/aspera/cli/bootstrapper.rb +9 -9
data/lib/aspera/cli/command_registry.rb +1 -1
data/lib/aspera/cli/command_spec.rb +6 -3
data/lib/aspera/cli/context.rb +3 -3
data/lib/aspera/cli/extended_value.rb +26 -26
data/lib/aspera/cli/formatter.rb +76 -54
data/lib/aspera/cli/gem_checker.rb +1 -1
data/lib/aspera/cli/hints.rb +2 -2
data/lib/aspera/cli/http.rb +22 -29
data/lib/aspera/cli/mailer.rb +7 -7
data/lib/aspera/cli/mcp_tool.rb +31 -4
data/lib/aspera/cli/option_declarator.rb +77 -0
data/lib/aspera/cli/options.schema.yaml +273 -3
data/lib/aspera/cli/parser.rb +539 -280
data/lib/aspera/cli/plugins/alee.rb +1 -1
data/lib/aspera/cli/plugins/aoc.rb +303 -314
data/lib/aspera/cli/plugins/ats.rb +25 -21
data/lib/aspera/cli/plugins/base.rb +357 -186
data/lib/aspera/cli/plugins/basic_auth.rb +0 -12
data/lib/aspera/cli/plugins/config.rb +76 -73
data/lib/aspera/cli/plugins/console.rb +8 -8
data/lib/aspera/cli/plugins/cos.rb +4 -3
data/lib/aspera/cli/plugins/factory.rb +2 -2
data/lib/aspera/cli/plugins/faspex5.rb +259 -248
data/lib/aspera/cli/plugins/faspio.rb +7 -2
data/lib/aspera/cli/plugins/httpgw.rb +1 -1
data/lib/aspera/cli/plugins/mcp.rb +11 -11
data/lib/aspera/cli/plugins/node.rb +227 -283
data/lib/aspera/cli/plugins/orchestrator.rb +23 -23
data/lib/aspera/cli/plugins/preview.rb +61 -64
data/lib/aspera/cli/plugins/server.rb +36 -31
data/lib/aspera/cli/plugins/shares.rb +174 -135
data/lib/aspera/cli/preset_actions.rb +39 -19
data/lib/aspera/cli/preset_manager.rb +74 -32
data/lib/aspera/cli/result.rb +18 -16
data/lib/aspera/cli/runner.rb +75 -39
data/lib/aspera/cli/secret_finder.rb +1 -1
data/lib/aspera/cli/sync_actions.rb +36 -35
data/lib/aspera/cli/terminal_formatter.rb +2 -2
data/lib/aspera/cli/transfer_actions.rb +17 -10
data/lib/aspera/cli/transfer_agent.rb +44 -44
data/lib/aspera/cli/transfer_progress.rb +7 -7
data/lib/aspera/cli/vault_manager.rb +34 -12
data/lib/aspera/cli/version.rb +1 -1
data/lib/aspera/cli/wizard.rb +17 -20
data/lib/aspera/colors.rb +3 -3
data/lib/aspera/command_line_builder.rb +17 -16
data/lib/aspera/command_line_converter.rb +1 -1
data/lib/aspera/coverage.rb +1 -2
data/lib/aspera/data_repository.rb +1 -1
data/lib/aspera/dot_container.rb +8 -8
data/lib/aspera/environment.rb +13 -13
data/lib/aspera/faspex_gw.rb +4 -4
data/lib/aspera/faspex_postproc.rb +14 -9
data/lib/aspera/graphql.rb +4 -2
data/lib/aspera/hash_ext.rb +2 -2
data/lib/aspera/json_rpc/client.rb +1 -1
data/lib/aspera/keychain/base.rb +10 -3
data/lib/aspera/keychain/encrypted_hash.rb +92 -17
data/lib/aspera/keychain/factory.rb +17 -5
data/lib/aspera/keychain/hashicorp_vault.rb +1 -1
data/lib/aspera/keychain/macos_security.rb +23 -25
data/lib/aspera/keychain/one_password_api.rb +86 -0
data/lib/aspera/keychain/one_password_base.rb +34 -0
data/lib/aspera/keychain/one_password_cli.rb +98 -0
data/lib/aspera/link_header.rb +2 -2
data/lib/aspera/log.rb +13 -13
data/lib/aspera/markdown.rb +5 -5
data/lib/aspera/nagios.rb +8 -8
data/lib/aspera/node_simulator.rb +33 -27
data/lib/aspera/oauth/base.rb +4 -5
data/lib/aspera/oauth/boot.rb +3 -3
data/lib/aspera/oauth/factory.rb +5 -5
data/lib/aspera/oauth/jwt.rb +5 -7
data/lib/aspera/oauth/web.rb +4 -4
data/lib/aspera/persistency_action_once.rb +4 -4
data/lib/aspera/persistency_folder.rb +8 -8
data/lib/aspera/preview/file_types.rb +4 -4
data/lib/aspera/preview/generator.rb +49 -46
data/lib/aspera/preview/options.rb +3 -2
data/lib/aspera/preview/terminal.rb +5 -5
data/lib/aspera/preview/utils.rb +65 -18
data/lib/aspera/products/connect.rb +2 -2
data/lib/aspera/products/desktop.rb +1 -1
data/lib/aspera/products/other.rb +2 -2
data/lib/aspera/products/transferd.rb +3 -3
data/lib/aspera/proxy_auto_config.rb +10 -10
data/lib/aspera/rest.rb +149 -115
data/lib/aspera/rest_error_analyzer.rb +3 -3
data/lib/aspera/rest_list.rb +10 -9
data/lib/aspera/schema/IBM Aspera Node API-4.4.6.yaml +6232 -0
data/lib/aspera/schema/IBM Aspera faspio Gateway API-1.0.0.yaml +249 -0
data/lib/aspera/schema/IBM Aspera on Cloud API-0.2.6-enhanced.yaml +39 -0
data/lib/aspera/schema/IBM_Aspera_Shares.yaml +4653 -0
data/lib/aspera/schema/documentation.rb +17 -11
data/lib/aspera/schema/reader.rb +78 -4
data/lib/aspera/schema/registry.rb +26 -7
data/lib/aspera/secret_hider.rb +5 -5
data/lib/aspera/ssh.rb +64 -31
data/lib/aspera/ssl.rb +3 -3
data/lib/aspera/sync/database.rb +2 -2
data/lib/aspera/sync/operations.rb +13 -13
data/lib/aspera/temp_file_manager.rb +24 -4
data/lib/aspera/transfer/faux_file.rb +2 -2
data/lib/aspera/transfer/parameters.rb +15 -15
data/lib/aspera/transfer/resumer.rb +9 -9
data/lib/aspera/transfer/spec.rb +1 -1
data/lib/aspera/transfer/spec.schema.yaml +1 -0
data/lib/aspera/uri_reader.rb +52 -15
data/lib/aspera/web_auth.rb +6 -5
data/lib/aspera/web_server_simple.rb +9 -9
data/lib/aspera/yaml.rb +4 -4
data.tar.gz.sig +0 -0
metadata +10 -4
metadata.gz.sig +0 -0
data/lib/aspera/cli/plugins/faspex.rb +0 -576
data/lib/aspera/transfer/uri.rb +0 -56

data/lib/aspera/schema/IBM_Aspera_Shares.yaml ADDED Viewed

@@ -0,0 +1,4653 @@
+# DO NOT EDIT THIS FILE MANUALLY
+# This file is automatically downloaded from:
+# https://raw.githubusercontent.com/laurent-martin/aspera-api-examples/refs/heads/main/openapi/IBM_Aspera_Shares.yaml
+# Use 'rake tools:openapi' to update this file
+openapi: 3.0.3
+info:
+  title: Aspera Shares API
+  contact:
+    name: IBM
+    email: aspera@ibm.com
+    url: https://ibm.com/aspera
+  version: 1.0.0
+  license:
+    name: Proprietary
+    url: "https://ibm.com/products/aspera"
+  description: |
+    Complete API documentation for Aspera Shares, a secure file sharing and collaboration platform.
+    In case of doubt, refer to the [official IBM Aspera Shares API reference](https://developer.ibm.com/apis/catalog/aspera--aspera-shares-api).
+    This API provides comprehensive access to:
+    - Files operations
+    - Transfer authorizations
+    - User and Group management
+    - Shares and access control
+    - Node operations
+    - Administrative functions
+    ## Authentication
+    The API uses HTTP Basic Authentication.
+    Include your credentials in the Authorization header:
+    ```
+    Authorization: Basic base64(username:password)
+    ```
+    ## Base URLs
+    - `/node_api` - API for file and transfer operation. A subset of HSTS Node API.
+    - `/api/v1` - API for Administration.
+servers:
+  - url: https://{hostname}
+    description: Aspera Shares Server
+    variables:
+      hostname:
+        default: shares.example.com
+        description: Your Aspera Shares hostname
+security:
+  - basicAuth: []
+tags:
+  - name: Information
+    description: Information information and health checks
+  - name: API Information
+    description: List of base endpoints and their capabilities
+  - name: Files
+    description: File operations (browse, info, create, rename, delete)
+  - name: Node Transfers
+    description: Transfer management
+  - name: Watch Folder
+    description: Watch folder management and monitoring
+  - name: Users
+    description: |
+      To create users, refer to Local User Management, SAML User Management, or LDAP User Management.
+      However, delete occurs under Authorizable Users although you can also delete local users from Local User Management.
+      It is important to note that only when the user type is database will the `local_user_id` be returned.
+      > [!NOTE]
+      > Manager authorization to these resources depends on the configuration option selected in the UI.
+  - name: Groups
+    description: Group management
+  - name: Shares
+    description: Share management and operations
+  - name: Nodes
+    description: Node management
+  - name: Transfer Settings
+    description: Transfer management and monitoring
+  - name: SMTP Servers
+    description: SMTP server configuration
+# ReDoc organization
+x-tagGroups:
+  - name: User Actions
+    tags:
+      - Information
+      - Files
+      - Node Transfers
+      - Watch Folder
+  - name: Administrative
+    tags:
+      - Users
+      - Groups
+      - Shares
+      - Nodes
+      - Transfer Settings
+      - SMTP Servers
+paths:
+  # API v1 Endpoints
+  /api/v1:
+    get:
+      tags:
+        - API Information
+      summary: Get API v1 information
+      description: Returns general information about API v1
+      operationId: getApiV1Info
+      responses:
+        "200":
+          description: API information
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  resource_type:
+                    type: string
+                  links:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        rel:
+                          type: string
+                        href:
+                          type: string
+                      required:
+                        - rel
+                        - href
+                required:
+                  - resource_type
+                  - links
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  # User Endpoints
+  /api/v1/data/users:
+    get:
+      tags:
+        - Users
+      summary: List Authorizable Users
+      description: Get All Authorizable Users
+      operationId: listUsers
+      responses:
+        "200":
+          description: List of users
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/AuthorizableUser"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /api/v1/data/users/{id}:
+    get:
+      tags:
+        - Users
+      summary: Get specific Authorizable User
+      description: Returns details of a specific user
+      operationId: getUser
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: User details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AuthorizableUser"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Users
+      summary: Delete user
+      description: |
+        Delete a Authorizable User.
+        > NOTE: This will delete any type of user (local, LDAP, and SAML).
+      operationId: deleteUser
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "204":
+          description: User deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/local_users:
+    get:
+      tags:
+        - Users
+      summary: List Local Users
+      description: Get All Local Users
+      operationId: listLocalUsers
+      responses:
+        "200":
+          description: List of local users
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/LocalUser"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+    post:
+      tags:
+        - Users
+      summary: Create local user
+      description: Creates a new local user account
+      operationId: createLocalUser
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/LocalUserCreate"
+      responses:
+        "201":
+          description: User created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LocalUser"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+  /api/v1/data/local_users/{id}:
+    get:
+      tags:
+        - Users
+      summary: Get specific Local User
+      description: Returns details of a specific user
+      operationId: getLocalUser
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: User details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LocalUser"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    put:
+      tags:
+        - Users
+      summary: Update local user
+      description: Updates an existing local user
+      operationId: updateLocalUser
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/LocalUserUpdate"
+      responses:
+        "200":
+          description: User updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LocalUser"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Users
+      summary: Delete local user
+      description: Delete a local User.
+      operationId: deleteLocalUser
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "204":
+          description: User deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/local_groups:
+    get:
+      tags:
+        - Groups
+      summary: List local groups
+      description: Returns a list of local groups
+      operationId: listLocalGroups
+      responses:
+        "200":
+          description: List of local groups
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/LocalGroup"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+    post:
+      tags:
+        - Groups
+      summary: Create local group
+      description: Creates a new local group
+      operationId: createLocalGroup
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/LocalGroupCreate"
+      responses:
+        "201":
+          description: Local group created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LocalGroup"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /api/v1/data/local_groups/{id}:
+    get:
+      tags:
+        - Groups
+      summary: Get local group
+      description: Returns details of a specific local group
+      operationId: getLocalGroup
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: Local group details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LocalGroup"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    put:
+      tags:
+        - Groups
+      summary: Update local group
+      description: Updates an existing local group
+      operationId: updateLocalGroup
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/LocalGroupUpdate"
+      responses:
+        "200":
+          description: Local group updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LocalGroup"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Groups
+      summary: Delete local group
+      description: Deletes a local group
+      operationId: deleteLocalGroup
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "204":
+          description: Local group deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/local_groups/{local_group_id}/local_users:
+    get:
+      tags:
+        - Groups
+      summary: List users of a local group
+      description: Returns all local users belonging to a specific local group
+      operationId: listLocalGroupUsers
+      parameters:
+        - name: local_group_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Local group ID
+      responses:
+        "200":
+          description: List of local users in the group
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/LocalUser"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/local_groups/{local_group_id}/local_users/{id}:
+    get:
+      tags:
+        - Groups
+      summary: Get user of a local group
+      operationId: getLocalGroupUser
+      parameters:
+        - name: local_group_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Local group ID
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: Local user details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LocalUser"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    put:
+      tags:
+        - Groups
+      summary: Update user of a local group
+      operationId: updateLocalGroupUser
+      parameters:
+        - name: local_group_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Local group ID
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/LocalUserUpdate"
+      responses:
+        "200":
+          description: Local user updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LocalUser"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Groups
+      summary: Remove user from a local group
+      operationId: deleteLocalGroupUser
+      parameters:
+        - name: local_group_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Local group ID
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "204":
+          description: User removed from group
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/ldap_configs:
+    get:
+      tags:
+        - Users
+      summary: List LDAP configurations
+      operationId: listLdapConfigs
+      responses:
+        "200":
+          description: List of LDAP configurations
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/LdapConfig"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+    post:
+      tags:
+        - Users
+      summary: Create LDAP configuration
+      operationId: createLdapConfig
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/LdapConfigCreate"
+      responses:
+        "201":
+          description: LDAP configuration created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LdapConfig"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /api/v1/data/ldap_configs/{id}:
+    get:
+      tags:
+        - Users
+      summary: Get LDAP configuration
+      operationId: getLdapConfig
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: LDAP configuration details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LdapConfig"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    put:
+      tags:
+        - Users
+      summary: Update LDAP configuration
+      operationId: updateLdapConfig
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/LdapConfigCreate"
+      responses:
+        "200":
+          description: LDAP configuration updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/LdapConfig"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Users
+      summary: Delete LDAP configuration
+      operationId: deleteLdapConfig
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "204":
+          description: LDAP configuration deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/ldap_users:
+    post:
+      tags:
+        - Users
+      summary: Add LDAP user
+      description: Add an LDAP user account
+      operationId: createLDAPUser
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/LDAPUserCreate"
+      responses:
+        "201":
+          description: User created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AuthorizableUser"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+  /api/v1/data/ldap_groups:
+    post:
+      tags:
+        - Groups
+      summary: Add LDAP group
+      description: Add an LDAP group account
+      operationId: createLDAPGroup
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/LDAPUserCreate"
+      responses:
+        "201":
+          description: Group created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Group"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+  /api/v1/data/saml_groups/import:
+    post:
+      tags:
+        - Groups
+      summary: Import SAML group
+      description: Import a SAML group account
+      operationId: importSAMLGroup
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SAMLUserImport"
+      responses:
+        "201":
+          description: Group created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Group"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+  /api/v1/data/saml_users/import:
+    post:
+      tags:
+        - Users
+      summary: Import SAML user
+      description: Import SAML user account
+      operationId: importSAMLUser
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SAMLUserImport"
+      responses:
+        "201":
+          description: User created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AuthorizableUser"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "403":
+          $ref: "#/components/responses/Forbidden"
+  /api/v1/data/users/{id}/share_permissions:
+    get:
+      tags:
+        - Users
+      summary: Get All Share Permissions for Specific User
+      description: Returns all share permissions for a specific user
+      operationId: getUserSharePermissions
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: User details
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/ShareUserPermission"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/users/{id}/share_permissions/{share_id}:
+    get:
+      tags:
+        - Users
+      summary: Get User's Specific Share Permission
+      description: Returns a specific share permission for a user
+      operationId: getUserSharePermission
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+        - name: share_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Share ID
+      responses:
+        "200":
+          description: Share permission details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ShareUserPermission"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  # Group Endpoints
+  /api/v1/data/users/{id}/app_authorizations:
+    get:
+      tags:
+        - Users
+      summary: Get user app authorizations
+      description: Returns app authorizations for a specific user
+      operationId: getUserAppAuthorizations
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: User app authorizations
+          content:
+            application/json:
+              schema:
+                type: object
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    put:
+      tags:
+        - Users
+      summary: Update user app authorizations
+      description: Updates app authorizations for a specific user
+      operationId: updateUserAppAuthorizations
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+      responses:
+        "200":
+          description: User app authorizations updated
+          content:
+            application/json:
+              schema:
+                type: object
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/groups:
+    get:
+      tags:
+        - Groups
+      summary: List groups
+      description: Returns a paginated list of groups
+      operationId: listGroups
+      responses:
+        "200":
+          description: List of groups
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/Group"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /api/v1/data/groups/{id}:
+    get:
+      tags:
+        - Groups
+      summary: Get group
+      description: Returns details of a specific group
+      operationId: getGroup
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: Group details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Group"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Groups
+      summary: Delete group
+      description: Deletes a group
+      operationId: deleteGroup
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "204":
+          description: Group deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  # Share Endpoints
+  /api/v1/data/groups/{id}/app_authorizations:
+    get:
+      tags:
+        - Groups
+      summary: Get group app authorizations
+      description: Returns app authorizations for a specific group
+      operationId: getGroupAppAuthorizations
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: Group app authorizations
+          content:
+            application/json:
+              schema:
+                type: object
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    put:
+      tags:
+        - Groups
+      summary: Update group app authorizations
+      description: Updates app authorizations for a specific group
+      operationId: updateGroupAppAuthorizations
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+      responses:
+        "200":
+          description: Group app authorizations updated
+          content:
+            application/json:
+              schema:
+                type: object
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/groups/{id}/users:
+    get:
+      tags:
+        - Groups
+      summary: List users of a group
+      description: Returns all authorizable users belonging to a specific group
+      operationId: listGroupUsers
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: List of users in the group
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/AuthorizableUser"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/groups/{id}/users/{user_id}:
+    get:
+      tags:
+        - Groups
+      summary: Get user of a group
+      operationId: getGroupUser
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+        - name: user_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: User ID
+      responses:
+        "200":
+          description: User details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AuthorizableUser"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    put:
+      tags:
+        - Groups
+      summary: Update user of a group
+      operationId: updateGroupUser
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+        - name: user_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: User ID
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+      responses:
+        "200":
+          description: Group user updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/AuthorizableUser"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Groups
+      summary: Remove user from a group
+      operationId: deleteGroupUser
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+        - name: user_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: User ID
+      responses:
+        "204":
+          description: User removed from group
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/groups/{id}/share_permissions:
+    get:
+      tags:
+        - Groups
+      summary: Get all share permissions for a group
+      description: Returns all share permissions for a specific group
+      operationId: getGroupSharePermissions
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: List of share permissions
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/ShareUserPermission"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/groups/{id}/share_permissions/{share_id}:
+    get:
+      tags:
+        - Groups
+      summary: Get group's specific share permission
+      description: Returns a specific share permission for a group
+      operationId: getGroupSharePermission
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+        - name: share_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Share ID
+      responses:
+        "200":
+          description: Share permission details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ShareUserPermission"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/shares:
+    get:
+      tags:
+        - Shares
+      summary: List shares
+      description: Returns a paginated list of shares
+      operationId: listShares
+      responses:
+        "200":
+          description: List of shares
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/Share"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+    post:
+      tags:
+        - Shares
+      summary: Create share
+      description: Creates a new share
+      operationId: createShare
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ShareCreate"
+      responses:
+        "201":
+          description: Share created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Share"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /api/v1/data/shares/{id}:
+    get:
+      tags:
+        - Shares
+      summary: Get share
+      description: Returns details of a specific share
+      operationId: getShare
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: Share details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Share"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    put:
+      tags:
+        - Shares
+      summary: Update share
+      description: Updates an existing share
+      operationId: updateShare
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ShareUpdate"
+      responses:
+        "200":
+          description: Share updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Share"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Shares
+      summary: Delete share
+      description: Deletes a share
+      operationId: deleteShare
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "204":
+          description: Share deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  # Shares nested permissions
+  /api/v1/data/shares/{share_id}/user_permissions:
+    get:
+      tags:
+        - Shares
+      summary: List user permissions for a share
+      operationId: listShareUserPermissions
+      parameters:
+        - name: share_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Share ID
+      responses:
+        "200":
+          description: List of user permissions
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/ShareUserPermission"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    post:
+      tags:
+        - Shares
+      summary: Create user permission for a share
+      operationId: createShareUserPermission
+      parameters:
+        - name: share_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Share ID
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SharePermissionCreate"
+      responses:
+        "201":
+          description: User permission created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ShareUserPermission"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /api/v1/data/shares/{share_id}/user_permissions/{id}:
+    get:
+      tags:
+        - Shares
+      summary: Get user permission for a share
+      operationId: getShareUserPermission
+      parameters:
+        - name: share_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Share ID
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: User permission details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ShareUserPermission"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    put:
+      tags:
+        - Shares
+      summary: Update user permission for a share
+      operationId: updateShareUserPermission
+      parameters:
+        - name: share_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Share ID
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SharePermissionCreate"
+      responses:
+        "200":
+          description: User permission updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ShareUserPermission"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Shares
+      summary: Delete user permission for a share
+      operationId: deleteShareUserPermission
+      parameters:
+        - name: share_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Share ID
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "204":
+          description: User permission deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /api/v1/data/shares/{share_id}/group_permissions:
+    get:
+      tags:
+        - Shares
+      summary: List group permissions for a share
+      operationId: listShareGroupPermissions
+      parameters:
+        - name: share_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Share ID
+      responses:
+        "200":
+          description: List of group permissions
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/ShareUserPermission"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    post:
+      tags:
+        - Shares
+      summary: Create group permission for a share
+      operationId: createShareGroupPermission
+      parameters:
+        - name: share_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Share ID
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SharePermissionCreate"
+      responses:
+        "201":
+          description: Group permission created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ShareUserPermission"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /api/v1/data/shares/{share_id}/group_permissions/{id}:
+    get:
+      tags:
+        - Shares
+      summary: Get group permission for a share
+      operationId: getShareGroupPermission
+      parameters:
+        - name: share_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Share ID
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: Group permission details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ShareUserPermission"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    put:
+      tags:
+        - Shares
+      summary: Update group permission for a share
+      operationId: updateShareGroupPermission
+      parameters:
+        - name: share_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Share ID
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SharePermissionCreate"
+      responses:
+        "200":
+          description: Group permission updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ShareUserPermission"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Shares
+      summary: Delete group permission for a share
+      operationId: deleteShareGroupPermission
+      parameters:
+        - name: share_id
+          in: path
+          required: true
+          schema:
+            type: integer
+          description: Share ID
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "204":
+          description: Group permission deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  # Node Endpoints
+  /api/v1/data/nodes:
+    get:
+      tags:
+        - Nodes
+      summary: List nodes
+      description: Returns a paginated list of nodes
+      operationId: listNodes
+      responses:
+        "200":
+          description: List of nodes
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/Node"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+    post:
+      tags:
+        - Nodes
+      summary: Create node
+      description: Creates a new node
+      operationId: createNode
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/NodeCreate"
+      responses:
+        "201":
+          description: Node created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Node"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /api/v1/data/nodes/{id}:
+    get:
+      tags:
+        - Nodes
+      summary: Get node
+      description: Returns details of a specific node
+      operationId: getNode
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: Node details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Node"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    put:
+      tags:
+        - Nodes
+      summary: Update node
+      description: Updates an existing node
+      operationId: updateNode
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/NodeCreate"
+      responses:
+        "200":
+          description: Node updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Node"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Nodes
+      summary: Delete node
+      description: Deletes a node
+      operationId: deleteNode
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "204":
+          description: Node deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  # SMTP Server Endpoints
+  /api/v1/data/smtp_server:
+    get:
+      tags:
+        - SMTP Servers
+      summary: Get SMTP server
+      description: Returns the configured SMTP server
+      operationId: getSmtpServer
+      responses:
+        "200":
+          description: SMTP server details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/SmtpServer"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    post:
+      tags:
+        - SMTP Servers
+      summary: Create SMTP server
+      description: Configures a new SMTP server
+      operationId: createSmtpServer
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SmtpServerCreate"
+      responses:
+        "201":
+          description: SMTP server created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/SmtpServer"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+    put:
+      tags:
+        - SMTP Servers
+      summary: Update SMTP server
+      description: Updates the SMTP server configuration
+      operationId: updateSmtpServer
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/SmtpServerUpdate"
+      responses:
+        "200":
+          description: SMTP server updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/SmtpServer"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  # Transfer Settings Endpoints
+  /api/v1/data/transfer_settings:
+    get:
+      tags:
+        - Transfer Settings
+      summary: Get global transfer settings
+      description: Returns global transfer settings that apply to all users and groups unless overridden
+      operationId: getGlobalTransferSettings
+      responses:
+        "200":
+          description: Global transfer settings
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/TransferSettings"
+              example:
+                min_connect_version: "3.6.1"
+                upload_target_rate: "10.0 Kbps"
+                upload_target_rate_cap: null
+                download_target_rate: null
+                download_target_rate_cap: null
+                starting_policy: ""
+                allowed_policy: ""
+                encryption: ""
+                encryption_at_rest: ""
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+    put:
+      tags:
+        - Transfer Settings
+      summary: Update global transfer settings
+      description: |
+        Updates global transfer settings. Use blank strings to indicate inherited settings.
+        Valid values:
+        - starting_policy: "", "fixed", "high", "fair", "low"
+        - allowed_policy: "", "fixed, high, fair, and low", "high, fair, and low", "fair and low", "low"
+        - encryption: "", "Optional", "AES-128"
+        - encryption_at_rest: "", "Optional", "Required"
+      operationId: updateGlobalTransferSettings
+      requestBody:
+        required: false
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/TransferSettingsUpdate"
+      responses:
+        "200":
+          description: Transfer settings updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/TransferSettingsResponse"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /api/v1/data/users/{id}/transfer_settings:
+    get:
+      tags:
+        - Transfer Settings
+      summary: Get user transfer settings
+      description: |
+        Returns transfer settings specific to a user.
+        Returns 404 if the user doesn't have specific settings (inherits global settings).
+      operationId: getUserTransferSettings
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: User transfer settings
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/UserTransferSettings"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          description: User has no specific transfer settings (inherits global settings)
+    put:
+      tags:
+        - Transfer Settings
+      summary: Update user transfer settings
+      description: Updates transfer settings for a specific user
+      operationId: updateUserTransferSettings
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/TransferSettingsUpdate"
+      responses:
+        "200":
+          description: User transfer settings updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/UserTransferSettings"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+    delete:
+      tags:
+        - Transfer Settings
+      summary: Delete user transfer settings
+      description: |
+        Removes user-specific transfer settings, causing the user to inherit global settings.
+        Returns 204 even if no specific settings exist.
+      operationId: deleteUserTransferSettings
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "204":
+          description: User transfer settings deleted (user now inherits global settings)
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /api/v1/data/groups/{id}/transfer_settings:
+    get:
+      tags:
+        - Transfer Settings
+      summary: Get group transfer settings
+      description: |
+        Returns transfer settings specific to a group.
+        Returns 404 if the group doesn't have specific settings (inherits global settings).
+      operationId: getGroupTransferSettings
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "200":
+          description: Group transfer settings
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GroupTransferSettings"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          description: Group has no specific transfer settings (inherits global settings)
+    put:
+      tags:
+        - Transfer Settings
+      summary: Update group transfer settings
+      description: Updates transfer settings for a specific group
+      operationId: updateGroupTransferSettings
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/TransferSettingsUpdate"
+      responses:
+        "200":
+          description: Group transfer settings updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/GroupTransferSettings"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+    delete:
+      tags:
+        - Transfer Settings
+      summary: Delete group transfer settings
+      description: |
+        Removes group-specific transfer settings, causing the group to inherit global settings.
+        Returns 204 even if no specific settings exist.
+      operationId: deleteGroupTransferSettings
+      parameters:
+        - $ref: "#/components/parameters/IntegerIdInPath"
+      responses:
+        "204":
+          description: Group transfer settings deleted (group now inherits global settings)
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  # Node API Endpoints
+  /node_api:
+    get:
+      tags:
+        - Information
+      summary: Get Node API information
+      description: Returns general information about the Node API
+      operationId: getNodeApiInfo
+      responses:
+        "200":
+          description: Node API information
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  apis:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        name:
+                          type: string
+                        version:
+                          type: number
+                        url:
+                          type: string
+                      required:
+                        - name
+                        - version
+                        - url
+                required:
+                  - apis
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /node_api/ping:
+    get:
+      tags:
+        - Information
+      summary: Ping the Node API
+      description: Health check endpoint to verify Node API availability
+      operationId: pingNodeApi
+      security: [] # No authentication required for ping
+      responses:
+        "200":
+          description: Successful ping. Return empty string.
+          content:
+            text/html:
+              schema:
+                type: string
+                example: ""
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /node_api/info:
+    get:
+      tags:
+        - Information
+      summary: Get Node information
+      description: Returns detailed information about the Node
+      operationId: getNodeInfo
+      responses:
+        "200":
+          description: Node information
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/NodeInfo"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /node_api/transfers:
+    post:
+      tags:
+        - Node Transfers
+      summary: Create transfer
+      description: Initiates a new transfer
+      operationId: createNodeTransfer
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/TransferCreate"
+      responses:
+        "201":
+          description: Transfer created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Transfer"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /node_api/transfers/{id}:
+    get:
+      tags:
+        - Node Transfers
+      summary: Get transfer status
+      description: Returns the status and details of a specific transfer
+      operationId: getNodeTransfer
+      parameters:
+        - $ref: "#/components/parameters/TransferId"
+      responses:
+        "200":
+          description: Transfer details
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Transfer"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    put:
+      tags:
+        - Node Transfers
+      summary: Update transfer
+      description: Updates transfer properties (e.g., pause, resume)
+      operationId: updateNodeTransfer
+      parameters:
+        - $ref: "#/components/parameters/TransferId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                action:
+                  type: string
+                  enum: [pause, resume, cancel]
+      responses:
+        "200":
+          description: Transfer updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Transfer"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Node Transfers
+      summary: Delete/cancel transfer
+      description: Cancels and removes a transfer
+      operationId: deleteNodeTransfer
+      parameters:
+        - $ref: "#/components/parameters/TransferId"
+      responses:
+        "204":
+          description: Transfer deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /node_api/{share}/watchds/{daemon}/subscriptions:
+    post:
+      tags:
+        - Watch Folder
+      summary: Create watchd subscription
+      description: Creates a new watchd subscription for monitoring file changes
+      operationId: createWatchdSubscription
+      parameters:
+        - name: share
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Share identifier
+        - name: daemon
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Watchd daemon identifier
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/WatchdSubscription"
+      responses:
+        "201":
+          description: Subscription created
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/WatchdSubscription"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /node_api/{share}/watchds/{daemon}/subscriptions/{subscription}:
+    put:
+      tags:
+        - Watch Folder
+      summary: Update watchd subscription
+      description: Updates an existing watchd subscription
+      operationId: updateWatchdSubscription
+      parameters:
+        - name: share
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Share identifier
+        - name: daemon
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Watchd daemon identifier
+        - name: subscription
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Subscription identifier
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/WatchdSubscription"
+      responses:
+        "200":
+          description: Subscription updated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/WatchdSubscription"
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /node_api/{share}/watchds/{daemon}/subscriptions/{subscription}/snapshots:
+    post:
+      tags:
+        - Watch Folder
+      summary: Create watchd snapshot
+      description: Creates a snapshot for a watchd subscription
+      operationId: createWatchdSnapshot
+      parameters:
+        - name: share
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Share identifier
+        - name: daemon
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Watchd daemon identifier
+        - name: subscription
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Subscription identifier
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+      responses:
+        "201":
+          description: Snapshot created
+          content:
+            application/json:
+              schema:
+                type: object
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /node_api/{share}/watchds/{daemon}/subscriptions/{subscription}/results:
+    post:
+      tags:
+        - Watch Folder
+      summary: Create watchd result
+      description: Creates a result entry for a watchd subscription
+      operationId: createWatchdResult
+      parameters:
+        - name: share
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Share identifier
+        - name: daemon
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Watchd daemon identifier
+        - name: subscription
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Subscription identifier
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+      responses:
+        "201":
+          description: Result created
+          content:
+            application/json:
+              schema:
+                type: object
+        "400":
+          $ref: "#/components/responses/BadRequest"
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /node_api/{share}/watchds/{daemon}/subscriptions/{subscription}/results/{result}:
+    get:
+      tags:
+        - Watch Folder
+      summary: Get watchd result
+      description: Retrieves a specific watchd result
+      operationId: getWatchdResult
+      parameters:
+        - name: share
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Share identifier
+        - name: daemon
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Watchd daemon identifier
+        - name: subscription
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Subscription identifier
+        - name: result
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Result identifier
+      responses:
+        "200":
+          description: Result details
+          content:
+            application/json:
+              schema:
+                type: object
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+    delete:
+      tags:
+        - Watch Folder
+      summary: Delete watchd result
+      description: Deletes a watchd result
+      operationId: deleteWatchdResult
+      parameters:
+        - name: share
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Share identifier
+        - name: daemon
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Watchd daemon identifier
+        - name: subscription
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Subscription identifier
+        - name: result
+          in: path
+          required: true
+          schema:
+            type: string
+          description: Result identifier
+      responses:
+        "204":
+          description: Result deleted
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+        "404":
+          $ref: "#/components/responses/NotFound"
+  /node_api/space:
+    post:
+      tags:
+        - Files
+      summary: Get space information
+      description:
+        "Get the total and available space for the file system, drives\
+        \ or partitions (logical or physical) that host one or more queried paths."
+      operationId: getSpaceInfo
+      requestBody:
+        description: The request body with an array of paths.
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/space-post-request"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/space-post-200"
+        "400":
+          description: Bad Request. Request contains a formatting or syntax error.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "500":
+          description: Internal Server Error. The server configuration is invalid.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+  /node_api/files/browse:
+    post:
+      tags:
+        - Files
+      summary: Browse the specified path
+      description: Retrieve metadata about the contents of the specified path.
+      operationId: browseFiles
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/filesBrowseRequest"
+        required: true
+      responses:
+        "200":
+          description: OK - Successful response
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/filesBrowseResponse"
+        "400":
+          description: Bad Request. Request contains a formatting or syntax error.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "500":
+          description: Internal Server Error. The server configuration is invalid.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+  /node_api/files/info:
+    post:
+      tags:
+        - Files
+      summary: Get metadata for specified paths
+      description:
+        "Get metadata for the files and directories that are specified in an\
+        \ array of paths. To get file information by\
+        \ using bearer token authentication, use the /files/{id} endpoint."
+      operationId: getFileInfo
+      requestBody:
+        description: An array of pathnames for which to return file metadata.
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/files-info-post-request"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/files-info-post-200"
+        "400":
+          description: Bad Request. Request contains a formatting or syntax error.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "404":
+          description: Not Found. Invalid pathname.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "500":
+          description: Internal Server Error. The server configuration is invalid.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+  /node_api/files/create:
+    post:
+      tags:
+        - Files
+      summary: Create files and directories
+      description: All requests to this endpoint use the same headers.
+      operationId: createFile
+      requestBody:
+        description:
+          "An array of pathnames to create and the type of object (directory,\
+          \ file, or symbolic link)."
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/files-create-post-request"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/files-create-post-200"
+        "400":
+          description: Bad Request. Request contains a formatting or syntax error.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "404":
+          description: Not Found. Invalid pathname.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "409":
+          description: Conflict. Path already exists.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "500":
+          description: Internal Server Error. The server configuration is invalid.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+  /node_api/files/rename:
+    post:
+      tags:
+        - Files
+      summary: Rename files and directories
+      description: Rename files and directories
+      operationId: renameFile
+      requestBody:
+        description: An array of pathnames, with their current and new names.
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/files-rename-post-request"
+        required: true
+      responses:
+        "200":
+          description: OK. If an error occurred performing the rename operation for a specific path, the error is returned as part of the response element for that path.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/files-rename-post-200"
+        "400":
+          description: Bad Request. Request contains a formatting or syntax error.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "500":
+          description: Internal Server Error. The server configuration is invalid.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+  /node_api/files/delete:
+    post:
+      tags:
+        - Files
+      summary: Delete files and directories
+      description: Delete file and directories
+      operationId: deleteFiles
+      requestBody:
+        description:
+          "An array of pathnames to delete. For directories, specify the\
+          \ behavior for deleting non-empty directories."
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/files-delete-post-request"
+        required: true
+      responses:
+        "200":
+          description:
+            "OK. Pathnames from the request are returned. If a pathname\
+            \ could not be deleted, it is followed by an error message."
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/files-delete-post-200"
+        "400":
+          description: Bad Request. Request contains a formatting or syntax error.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "403":
+          description:
+            Forbidden. The directory cannot be deleted because it contains
+            files that are in use.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "404":
+          description: Not Found. The file could not be found.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "409":
+          description:
+            Directory Not Empty. The directory is not empty and "recursive_delete"
+            is set to "false".
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "500":
+          description: Internal Server Error. The server configuration is invalid.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+  /node_api/files/upload_setup:
+    post:
+      tags:
+        - Files
+      summary: Create an upload transfer specification with token
+      description:
+        "FASP transfers can use transfer tokens to authorize the transfer.\
+        Transfer tokens are the most restrictive of the tokens and require careful\
+        configuration. Token expiration is configurable on HSTS/HSTE. \
+        Note: Transfer specifications that are set in aspera.conf overwrite the \
+        corresponding values in the request body when the token is created."
+      operationId: setupUpload
+      requestBody:
+        description: The upload token configuration.
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/files-upload_setup-post-request"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/files-upload_setup-post-200"
+        "400":
+          description: Bad Request. Request contains a formatting or syntax error.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "404":
+          description: Not Found. Invalid pathnames.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "500":
+          description: Internal Server Error. The server configuration is invalid.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+  /node_api/files/sync_setup:
+    post:
+      tags:
+        - Files
+      summary: Create a sync setup
+      description: Returns a transfer specification for sync operations
+      operationId: setupSync
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+      responses:
+        "200":
+          description: Sync setup response
+          content:
+            application/json:
+              schema:
+                type: object
+        "400":
+          description: Bad Request
+        "401":
+          $ref: "#/components/responses/Unauthorized"
+  /node_api/files/download_setup:
+    post:
+      tags:
+        - Files
+      summary: Create a download transfer specification with token
+      description:
+        FASP transfers can use transfer tokens to authorize the transfer.
+        Transfer tokens are the most restrictive of the tokens and require careful
+        configuration. Token expiration is configurable on HSTS/HSTE.
+      operationId: setupDownload
+      requestBody:
+        description: The download token configuration.
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/files-download_setup-post-request"
+        required: true
+      responses:
+        "200":
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/files-download_setup-post-200"
+        "400":
+          description: Bad Request. Request contains a formatting or syntax error.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "404":
+          description: Not Found. Invalid pathnames.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        "500":
+          description: Internal Server Error. The server configuration is invalid.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+components:
+  securitySchemes:
+    basicAuth:
+      type: http
+      scheme: basic
+      description: HTTP Basic Authentication with username and password
+  parameters:
+    IntegerIdInPath:
+      name: id
+      in: path
+      required: true
+      schema:
+        type: integer
+      description: Entity ID
+    TransferId:
+      name: id
+      in: path
+      required: true
+      schema:
+        type: string
+      description: Transfer ID
+  schemas:
+    # User Schemas
+    AuthorizableUser:
+      type: object
+      required:
+        - id
+        - username
+        - email
+        - directory_id
+        - disabled
+        - locked
+        - home_share_disabled
+        - items_per_page
+        - notify_on_my_share_authorization
+        - notify_on_self_registration_request
+        - notify_on_share_authorization
+        - notify_on_transfer_complete
+        - suppress_connect_install_dialog
+        - created_at
+        - updated_at
+        - urn
+        - directory_user
+      properties:
+        account_expires_on:
+          type: string
+          format: date-time
+          nullable: true
+        comments:
+          type: string
+          nullable: true
+        created_at:
+          type: string
+          format: date-time
+          example: 2016-06-14T18:12:46Z
+        date_delimiter:
+          type: string
+          nullable: true
+        date_order:
+          type: string
+          nullable: true
+        directory_id:
+          type: integer
+          format: int32
+          example: 44
+        disabled:
+          type: boolean
+          example: false
+        email:
+          type: string
+          format: email
+          example: demo@asperasoft.com
+        first_name:
+          type: string
+          nullable: true
+        home_share_disabled:
+          type: boolean
+          example: false
+        home_share_id:
+          type: integer
+          format: int32
+          nullable: true
+        id:
+          type: integer
+          format: int32
+          example: 130
+        items_per_page:
+          type: integer
+          format: int32
+          example: 50
+        last_login_at:
+          type: string
+          format: date-time
+          nullable: true
+        last_logout_at:
+          type: string
+          format: date-time
+          nullable: true
+        last_name:
+          type: string
+          nullable: true
+        last_request_at:
+          type: string
+          format: date-time
+          nullable: true
+        locked:
+          type: boolean
+          example: false
+        notify_on_my_share_authorization:
+          type: boolean
+        notify_on_self_registration_request:
+          type: boolean
+        notify_on_share_authorization:
+          type: boolean
+        notify_on_transfer_complete:
+          type: boolean
+        number_delimiter:
+          type: string
+          nullable: true
+        number_separator:
+          type: string
+          nullable: true
+        status:
+          type: string
+          nullable: true
+        status_at:
+          type: string
+          format: date-time
+          nullable: true
+        status_message:
+          type: string
+          nullable: true
+        suppress_connect_install_dialog:
+          type: boolean
+        synced_at:
+          type: string
+          format: date-time
+          nullable: true
+        time_format:
+          type: string
+          nullable: true
+        time_zone:
+          type: string
+          nullable: true
+        unlocked_at:
+          type: string
+          format: date-time
+          nullable: true
+        updated_at:
+          type: string
+          format: date-time
+          example: 2016-06-14T18:12:46Z
+        urn:
+          type: string
+          example: urn:user:ZGF0YWJhc2UsbG9jYWwsODUK
+        username:
+          type: string
+          example: apiuser
+        directory_user:
+          oneOf:
+            - type: object
+              properties:
+                type:
+                  type: string
+                  enum: [database]
+                local_user_id:
+                  type: integer
+              required:
+                - local_user_id
+                - type
+            - type: object
+              properties:
+                type:
+                  type: string
+                  enum: [saml]
+              required:
+                - type
+            - type: object
+              properties:
+                type:
+                  type: string
+                  enum: [active_directory]
+              required:
+                - type
+      additionalProperties: false
+    LocalUser:
+      type: object
+      required:
+        - id
+        - username
+        - email
+        - created_at
+        - updated_at
+        - password_status
+      properties:
+        created_at:
+          type: string
+          format: date-time
+          example: 2016-06-14T18:12:46Z
+        email:
+          type: string
+          format: email
+          example: demo@asperasoft.com
+        first_name:
+          type: string
+          nullable: true
+        id:
+          type: integer
+          format: int32
+          example: 130
+        last_name:
+          type: string
+          nullable: true
+        login_token:
+          type: string
+          nullable: true
+        login_token_expires_at:
+          type: string
+          format: date-time
+          nullable: true
+        password_changed_on:
+          type: string
+          format: date-time
+          nullable: true
+        password_status:
+          type: string
+          enum: [never set, expired, expiring_soon, reset_required]
+        updated_at:
+          type: string
+          format: date-time
+          example: 2016-06-14T18:12:46Z
+        username:
+          type: string
+          example: apiuser
+        user_id:
+          type: integer
+          format: int32
+          example: 130
+      additionalProperties: false
+    LocalUserCreate:
+      type: object
+      required:
+        - username
+        - email
+      properties:
+        username:
+          type: string
+          minLength: 3
+          maxLength: 50
+          example: johndoe
+        password:
+          type: string
+          format: password
+          minLength: 8
+        email:
+          type: string
+          format: email
+          example: john.doe@example.com
+        first_name:
+          type: string
+          example: John
+        last_name:
+          type: string
+          example: Doe
+        send_welcome_email:
+          type: boolean
+          default: false
+          description: |
+            `send_welcome_email` with `password` triggers 'Login information' email with 'Login' link
+            while it alone triggers 'Login information' email with 'Change password' link.
+    LocalUserUpdate:
+      type: object
+      properties:
+        username:
+          type: string
+          minLength: 3
+          maxLength: 50
+          example: johndoe
+        password:
+          type: string
+          format: password
+          minLength: 8
+        email:
+          type: string
+          format: email
+          example: john.doe@example.com
+        first_name:
+          type: string
+          example: John
+        last_name:
+          type: string
+          example: Doe
+    LDAPUserCreate:
+      type: object
+      required:
+        - user
+      properties:
+        user:
+          type: string
+          example: johndoe
+    SAMLUserImport:
+      type: object
+      required:
+        - id
+        - name_id
+      properties:
+        id:
+          type: string
+          example: johndoe
+        name_id:
+          type: string
+        email:
+          type: string
+          format: email
+          example: john.doe@example.com
+        given_name:
+          type: string
+          example: John
+        surname:
+          type: string
+          example: Doe
+    # Group Schemas
+    Group:
+      type: object
+      properties:
+        id:
+          type: integer
+          example: 456
+        name:
+          type: string
+          example: Engineering
+        description:
+          type: string
+          example: Engineering department group
+        member_count:
+          type: integer
+          description: Number of members in the group
+        created_at:
+          type: string
+          format: date-time
+        updated_at:
+          type: string
+          format: date-time
+    GroupCreate:
+      type: object
+      required:
+        - name
+      properties:
+        name:
+          type: string
+          minLength: 1
+          maxLength: 100
+        description:
+          type: string
+    GroupUpdate:
+      type: object
+      properties:
+        name:
+          type: string
+          minLength: 1
+          maxLength: 100
+        description:
+          type: string
+    # Share Schemas
+    Share:
+      type: object
+      properties:
+        id:
+          type: integer
+          example: 789
+        name:
+          type: string
+          example: Project Files
+        description:
+          type: string
+        node_id:
+          type: integer
+          description: Associated node ID
+        path:
+          type: string
+          description: Share root path
+          example: /shares/project
+        created_by:
+          type: integer
+          description: User ID of creator
+        created_at:
+          type: string
+          format: date-time
+        updated_at:
+          type: string
+          format: date-time
+    ShareCreate:
+      type: object
+      required:
+        - name
+        - node_id
+      properties:
+        name:
+          type: string
+          minLength: 1
+        description:
+          type: string
+        node_id:
+          type: integer
+        path:
+          type: string
+    ShareUpdate:
+      type: object
+      properties:
+        name:
+          type: string
+        description:
+          type: string
+        path:
+          type: string
+    # Node Schemas
+    Node:
+      type: object
+      required:
+        - api_port
+        - api_username
+        - browse_count
+        - bytes_unknown
+        - created_at
+        - host
+        - id
+        - name
+        - open_timeout
+        - ref_uuid
+        - salt
+        - ssl
+        - sync_enabled
+        - timeout
+        - updated_at
+        - verify_ssl
+      properties:
+        api_port:
+          type: integer
+          format: int32
+          example: 9092
+        api_prefix:
+          type: string
+          nullable: true
+        api_username:
+          type: string
+          example: loc1
+        azu_access_key:
+          type: string
+          nullable: true
+        azu_path:
+          type: string
+          nullable: true
+        azu_storage_account:
+          type: string
+          nullable: true
+        browse_count:
+          type: integer
+          format: int32
+          example: 0
+        bytes_free_string:
+          type: string
+          nullable: true
+        bytes_total_string:
+          type: string
+          nullable: true
+        bytes_unknown:
+          type: boolean
+          example: false
+        cluster_uuid:
+          type: string
+          format: uuid
+          nullable: true
+        created_at:
+          type: string
+          format: date-time
+          example: 2016-05-03T18:12:56Z
+        docroot:
+          type: string
+          nullable: true
+        error_bytes_free_size:
+          type: integer
+          format: int64
+          nullable: true
+        error_percent_free:
+          type: number
+          format: float
+          nullable: true
+        host:
+          type: string
+          example: 192.168.10.40
+        http_fallback_port:
+          type: integer
+          format: int32
+          nullable: true
+        id:
+          type: integer
+          format: int32
+          example: 3
+        name:
+          type: string
+          example: client
+        open_timeout:
+          type: integer
+          format: int32
+          example: 10
+        percent_free:
+          type: number
+          format: float
+          nullable: true
+        ref_uuid:
+          type: string
+          format: uuid
+          example: 6138aeec-4cf3-4fa1-8d77-1d4b659db9fa
+        root_response:
+          type: string
+          nullable: true
+        salt:
+          type: string
+          example: 02757fd5fb6d74b3d67d
+        sas_path:
+          type: string
+          nullable: true
+        sas_url:
+          type: string
+          format: uri
+          nullable: true
+        ssh_port:
+          type: integer
+          format: int32
+          nullable: true
+        ssl:
+          type: boolean
+          example: true
+        status:
+          type: string
+          nullable: true
+        status_at:
+          type: string
+          format: date-time
+          nullable: true
+        status_message:
+          type: string
+          nullable: true
+        storage_type:
+          type: string
+          nullable: true
+        sync_enabled:
+          type: boolean
+          example: false
+        timeout:
+          type: integer
+          format: int32
+          example: 30
+        updated_at:
+          type: string
+          format: date-time
+          example: 2016-05-03T18:12:56Z
+        verify_ssl:
+          type: boolean
+          example: false
+        warn_bytes_free_size:
+          type: integer
+          format: int64
+          nullable: true
+        warn_percent_free:
+          type: number
+          format: float
+          nullable: true
+    ShareUserPermission:
+      type: object
+      required:
+        - browse_permission
+        - content_availability_permission
+        - created_at
+        - delete_permission
+        - download_permission
+        - id
+        - manage_permission
+        - mkdir_permission
+        - rename_permission
+        - share_id
+        - updated_at
+        - upload_permission
+        - user_id
+      properties:
+        browse_permission:
+          type: boolean
+          example: true
+        content_availability_permission:
+          type: boolean
+          example: true
+        created_at:
+          type: string
+          format: date-time
+          example: 2016-05-03T18:12:56Z
+        delete_permission:
+          type: boolean
+          example: true
+        download_permission:
+          type: boolean
+          example: true
+        id:
+          type: integer
+          format: int32
+          example: 14
+        last_viewed_at:
+          type: string
+          format: date-time
+          nullable: true
+        last_viewed_comments_at:
+          type: string
+          format: date-time
+          nullable: true
+        manage_permission:
+          type: boolean
+          example: true
+        mkdir_permission:
+          type: boolean
+          example: true
+        rename_permission:
+          type: boolean
+          example: true
+        share_id:
+          type: integer
+          format: int32
+          example: 11
+        updated_at:
+          type: string
+          format: date-time
+          example: 2016-05-03T18:12:56Z
+        upload_permission:
+          type: boolean
+          example: true
+        user_id:
+          type: integer
+          format: int32
+          example: 24
+      additionalProperties: false
+    SharePermissionCreate:
+      type: object
+      description: Fields to set when creating or updating a share permission
+      properties:
+        user_id:
+          type: integer
+          format: int32
+          description: User ID (for user permissions)
+        group_id:
+          type: integer
+          format: int32
+          description: Group ID (for group permissions)
+        browse_permission:
+          type: boolean
+        download_permission:
+          type: boolean
+        upload_permission:
+          type: boolean
+        delete_permission:
+          type: boolean
+        mkdir_permission:
+          type: boolean
+        rename_permission:
+          type: boolean
+        manage_permission:
+          type: boolean
+        content_availability_permission:
+          type: boolean
+    LocalGroup:
+      type: object
+      properties:
+        id:
+          type: integer
+          format: int32
+          example: 10
+        name:
+          type: string
+          example: engineers
+        description:
+          type: string
+          nullable: true
+        created_at:
+          type: string
+          format: date-time
+        updated_at:
+          type: string
+          format: date-time
+      additionalProperties: false
+    LocalGroupCreate:
+      type: object
+      required:
+        - name
+      properties:
+        name:
+          type: string
+          example: engineers
+        description:
+          type: string
+    LocalGroupUpdate:
+      type: object
+      properties:
+        name:
+          type: string
+          example: engineers
+        description:
+          type: string
+    LdapConfig:
+      type: object
+      properties:
+        id:
+          type: integer
+          format: int32
+        host:
+          type: string
+        port:
+          type: integer
+        base_dn:
+          type: string
+        bind_dn:
+          type: string
+        ssl:
+          type: boolean
+        created_at:
+          type: string
+          format: date-time
+        updated_at:
+          type: string
+          format: date-time
+    LdapConfigCreate:
+      type: object
+      required:
+        - host
+        - base_dn
+      properties:
+        host:
+          type: string
+          example: ldap.example.com
+        port:
+          type: integer
+          example: 389
+        base_dn:
+          type: string
+          example: dc=example,dc=com
+        bind_dn:
+          type: string
+        bind_password:
+          type: string
+          format: password
+        ssl:
+          type: boolean
+          default: false
+    NodeCreate:
+      type: object
+      required:
+        - name
+        - host
+        - api_username
+        - api_password
+      properties:
+        name:
+          type: string
+          example: client
+        host:
+          type: string
+          example: 192.168.10.40
+        api_username:
+          type: string
+          example: loc1
+        api_password:
+          type: string
+          format: password
+          example: strong_password_here
+        port:
+          type: integer
+          format: int32
+          default: 9092
+          example: 9092
+        ssl:
+          type: boolean
+          default: true
+          example: true
+        verify_ssl:
+          type: boolean
+          default: false
+          example: false
+        timeout:
+          type: integer
+          format: int32
+          description: Timeout in seconds
+          default: 30
+          example: 30
+        open_timeout:
+          type: integer
+          format: int32
+          description: Open timeout in seconds
+          default: 10
+          example: 10
+      additionalProperties: false
+    # Node API Schemas
+    NodeInfo:
+      type: object
+      properties:
+        current_time:
+          type: string
+        application:
+          type: string
+        version:
+          type: string
+        capabilities:
+          type: array
+          items:
+            type: object
+            properties:
+              name:
+                type: string
+              value:
+                type: boolean
+            required:
+              - name
+              - value
+      required:
+        - current_time
+        - application
+        - version
+        - capabilities
+    TransferCreate:
+      type: object
+      required:
+        - transfer_spec
+      properties:
+        transfer_spec:
+          type: object
+          description: Aspera transfer specification
+    Transfer:
+      type: object
+      properties:
+        id:
+          type: string
+          example: xfer-123abc
+        status:
+          type: string
+          enum: [pending, running, completed, failed, cancelled, paused]
+        direction:
+          type: string
+          enum: [upload, download, sync]
+        bytes_transferred:
+          type: integer
+          format: int64
+        total_bytes:
+          type: integer
+          format: int64
+        percentage:
+          type: number
+          format: float
+        rate_kbps:
+          type: integer
+          description: Current transfer rate in Kbps
+        started_at:
+          type: string
+          format: date-time
+        completed_at:
+          type: string
+          format: date-time
+    WatchdSubscription:
+      type: object
+      properties:
+        id:
+          type: string
+        name:
+          type: string
+        path:
+          type: string
+          description: Path to monitor
+        events:
+          type: array
+          items:
+            type: string
+            enum: [create, modify, delete, move]
+        active:
+          type: boolean
+    # SMTP Server Schemas
+    SmtpServer:
+      type: object
+      properties:
+        id:
+          type: integer
+          example: 13
+        server:
+          type: string
+          description: SMTP server hostname
+          example: smtp.gmail.com
+        port:
+          type: integer
+          description: SMTP server port
+          example: 587
+        username:
+          type: string
+          description: SMTP authentication username
+          example: demo@asperasoft.net
+        from:
+          type: string
+          description: From email address
+          example: aspera-systems@asperasoft.net
+        from_address:
+          type: string
+          nullable: true
+          description: Optional custom from address
+        from_name:
+          type: string
+          nullable: true
+          description: Optional custom from name
+        tls:
+          type: boolean
+          description: Use TLS encryption
+          example: true
+        timeout:
+          type: integer
+          description: Connection timeout in seconds
+          example: 3
+        status:
+          type: string
+          nullable: true
+          description: Server status
+        status_at:
+          type: string
+          format: date-time
+          nullable: true
+          description: Last status check timestamp
+        status_message:
+          type: string
+          nullable: true
+          description: Status message or error
+        created_at:
+          type: string
+          format: date-time
+        updated_at:
+          type: string
+          format: date-time
+        salt:
+          type: string
+          description: Salt for password encryption
+          example: 429979e40788ba6e9df1
+    SmtpServerCreate:
+      type: object
+      required:
+        - server
+        - port
+        - username
+        - password
+      properties:
+        server:
+          type: string
+          example: smtp.gmail.com
+        port:
+          type: integer
+          example: 587
+        username:
+          type: string
+          example: user@example.com
+        password:
+          type: string
+          format: password
+          description: SMTP authentication password
+        from:
+          type: string
+          format: email
+        from_address:
+          type: string
+          format: email
+        from_name:
+          type: string
+        tls:
+          type: boolean
+          default: true
+        timeout:
+          type: integer
+          default: 3
+          minimum: 1
+          maximum: 60
+    SmtpServerUpdate:
+      type: object
+      properties:
+        server:
+          type: string
+        port:
+          type: integer
+        username:
+          type: string
+        password:
+          type: string
+          format: password
+        from:
+          type: string
+          format: email
+        from_address:
+          type: string
+          format: email
+        from_name:
+          type: string
+        tls:
+          type: boolean
+        timeout:
+          type: integer
+          minimum: 1
+          maximum: 60
+    # Transfer Settings Schemas
+    TransferSettings:
+      type: object
+      properties:
+        min_connect_version:
+          type: string
+          description: Minimum Aspera Connect version required (format X.Y or X.Y.Z or X.Y.Z.W)
+          example: "3.6.1"
+          nullable: true
+        upload_target_rate:
+          type: string
+          description: Target upload rate (e.g., "1.5 Gbps", "500Mbps", "10 K", "3000")
+          example: "10.0 Kbps"
+          nullable: true
+        upload_target_rate_cap:
+          type: string
+          description: Maximum upload rate cap
+          example: "500.0 Mbps"
+          nullable: true
+        download_target_rate:
+          type: string
+          description: Target download rate
+          nullable: true
+        download_target_rate_cap:
+          type: string
+          description: Maximum download rate cap
+          nullable: true
+        starting_policy:
+          type: string
+          enum: ["", "fixed", "high", "fair", "low"]
+          description: Starting bandwidth policy (empty string indicates inherit)
+          nullable: true
+        allowed_policy:
+          type: string
+          enum:
+            [
+              "",
+              "fixed, high, fair, and low",
+              "high, fair, and low",
+              "fair and low",
+              "low",
+            ]
+          description: Allowed bandwidth policies (empty string indicates inherit)
+          nullable: true
+        encryption:
+          type: string
+          enum: ["", "Optional", "AES-128"]
+          description: Encryption setting (empty string indicates inherit)
+          nullable: true
+        encryption_at_rest:
+          type: string
+          enum: ["", "Optional", "Required"]
+          description: Encryption at rest setting (empty string indicates inherit)
+          nullable: true
+    TransferSettingsUpdate:
+      type: object
+      properties:
+        min_connect_version:
+          type: string
+          description: Minimum Aspera Connect version (format X.Y or X.Y.Z or X.Y.Z.W)
+          example: "3.7.1"
+        upload_target_rate:
+          type: string
+          description: Target upload rate (e.g., "1.5 Gbps", "500Mbps", "10 K", "3000")
+          example: "10.0 Kbps"
+        upload_target_rate_cap:
+          type: string
+          description: Maximum upload rate cap
+          example: "22.0 Mbps"
+        download_target_rate:
+          type: string
+          description: Target download rate
+        download_target_rate_cap:
+          type: string
+          description: Maximum download rate cap
+        starting_policy:
+          type: string
+          enum: ["", "fixed", "high", "fair", "low"]
+          description: Starting bandwidth policy (blank = inherit)
+          nullable: true
+        allowed_policy:
+          type: string
+          enum:
+            [
+              "",
+              "fixed, high, fair, and low",
+              "high, fair, and low",
+              "fair and low",
+              "low",
+            ]
+          description: Allowed bandwidth policies (blank = inherit)
+        encryption:
+          type: string
+          enum: ["", "Optional", "AES-128"]
+          description: Encryption setting (blank = inherit)
+        encryption_at_rest:
+          type: string
+          enum: ["", "Optional", "Required"]
+          description: Encryption at rest (blank = inherit)
+        reset_all_defaults:
+          type: boolean
+          description: Reset all settings to system defaults
+    TransferSettingsResponse:
+      allOf:
+        - $ref: "#/components/schemas/TransferSettings"
+        - type: object
+          properties:
+            errors:
+              type: object
+              description: Validation errors for each field
+              properties:
+                upload_target_rate_cap:
+                  type: array
+                  items:
+                    type: string
+                upload_target_rate:
+                  type: array
+                  items:
+                    type: string
+                download_target_rate_cap:
+                  type: array
+                  items:
+                    type: string
+                download_target_rate:
+                  type: array
+                  items:
+                    type: string
+                allowed_policy:
+                  type: array
+                  items:
+                    type: string
+                starting_policy:
+                  type: array
+                  items:
+                    type: string
+            validation_context:
+              type: string
+              nullable: true
+    UserTransferSettings:
+      allOf:
+        - $ref: "#/components/schemas/TransferSettings"
+        - type: object
+          required:
+            - id
+            - authorizable_type
+            - authorizable_id
+          properties:
+            id:
+              type: integer
+              example: 3
+            authorizable_type:
+              type: string
+              enum: [Authorizable::User]
+              example: Authorizable::User
+            authorizable_id:
+              type: integer
+              description: User ID
+              example: 5
+            created_at:
+              type: string
+              format: date-time
+            updated_at:
+              type: string
+              format: date-time
+    GroupTransferSettings:
+      allOf:
+        - $ref: "#/components/schemas/TransferSettings"
+        - type: object
+          required:
+            - id
+            - authorizable_type
+            - authorizable_id
+          properties:
+            id:
+              type: integer
+              example: 13
+            authorizable_type:
+              type: string
+              enum: [Authorizable::Group]
+              example: Authorizable::Group
+            authorizable_id:
+              type: integer
+              description: Group ID
+              example: 1
+            created_at:
+              type: string
+              format: date-time
+            updated_at:
+              type: string
+              format: date-time
+    # Error Schema
+    Error:
+      type: object
+      required:
+        - error
+      properties:
+        error:
+          type: object
+          description: Error object
+          properties:
+            user_message:
+              type: string
+              description: Human-readable error message
+              example: API user authentication failed
+    filesBrowseRequest:
+      required:
+        - path
+      type: object
+      properties:
+        path:
+          type: string
+          description: The full pathname of the directory to browse.
+        skip:
+          type: integer
+          description:
+            Do not return information about the first number of files and
+            directories. Default 0.
+        count:
+          type: integer
+          description:
+            Return no more than "count" results.  It is the client’s responsibility
+            to keep track of number of results returned. Default 100.
+        sort:
+          type: string
+          description:
+            "Sort the results by \"path\", \"type\" (directory/file), \"\
+            size_a\"(bytes, ascending), \"size_d\" (bytes, descending), \"mtime_a\"\
+            \  (modification date, ascending), or \"mtime_d\" (modification date,\
+            \ descending)."
+        case_sensitive:
+          type: boolean
+          description:
+            "Specify if sort and basename are case sensitive (true) or\
+            \ not (false). Default: false."
+        filters:
+          $ref: "#/components/schemas/filesBrowseFilters"
+    filesBrowseFilters:
+      type: object
+      properties:
+        types:
+          type: array
+          description:
+            "Return data only for the specified content types: file, symbolic_link,\
+            \ or directory."
+          example:
+            - file
+            - directory
+          items:
+            type: string
+            enum:
+              - file
+              - symbolic_link
+              - directory
+        paths:
+          type: array
+          description: Return data only for path names that match the specified path.
+          example:
+            - /a/*
+            - b/*/c*
+          items:
+            type: string
+        basenames:
+          type: array
+          description:
+            Return data only for files with basenames that match the specified
+            basenames.
+          example:
+            - "*.jpg"
+            - "*.gif"
+          items:
+            type: string
+        size_min:
+          type: integer
+          description:
+            "Include files that are greater than or equal to size_min (in\
+            \ bytes). NOTE: This setting automatically restricts the results to files,\
+            \ equivalent to setting \"types\":\"file\"."
+          example: 1000
+        size_max:
+          type: integer
+          description:
+            "Include files that are less than size_max (in bytes). NOTE:\
+            \ This setting automatically restricts the results to files, equivalent\
+            \ to setting \"types\":\"file\"."
+          example: 10000
+        mtime_min:
+          type: string
+          description:
+            "Include files that were updated after mtime_min, in the format\
+            \ \"2011-01-31T12:59:59Z\", T or space in the middle; Z optional at the\
+            \ end."
+          example: 2011-01-01 00:00:00
+        mtime_max:
+          type: string
+          description:
+            "Include files that were updated before mtime_max, in the format\
+            \ \"2011-01-31T12:59:59Z\", T or space in the middle; Z optional at the\
+            \ end."
+          example: 2011-01-31 11:59:59
+      description: List of query filters that are applied to the source paths.
+    filesBrowseResponse:
+      type: object
+      properties:
+        self:
+          $ref: "#/components/schemas/filesBrowseMeta"
+        items:
+          type: array
+          items:
+            $ref: "#/components/schemas/filesBrowseMeta"
+    filesBrowseMeta:
+      type: object
+      properties:
+        path:
+          type: string
+          description: "The pathname of the file, directory, or symbolic link."
+          example: /Documents/Users/aspera
+        basename:
+          type: string
+          description: The base name of the path.
+          example: sample.txt
+        type:
+          type: string
+          description:
+            "The type of the path. Value is \"file\", \"directory\", or\
+            \ \"symbolic_link\"."
+          example: file
+        size:
+          type: integer
+          description:
+            "The size of the file or symbolic link, in bytes. Directory\
+            \ size is reported as 0."
+          example: 3290353589
+        mtime:
+          type: string
+          description: "The item's modification time, in ISO format."
+          example: 2011-01-31 11:59:59
+        permissions:
+          type: array
+          items:
+            $ref: "#/components/schemas/filesBrowsePermissions"
+        target:
+          $ref: "#/components/schemas/filesBrowseTarget"
+      description:
+        JSON object that contains the metadata associated with the base
+        path of the request.
+    filesBrowsePermissions:
+      type: object
+      properties:
+        name:
+          type: string
+          description:
+            "The permissions that is set on the content. Value is \"view\"\
+            , \"edit\", and \"delete\"."
+          example: edit
+    filesBrowseTarget:
+      type: object
+      properties:
+        path:
+          type: string
+          description:
+            "The pathname of the file, directory, or symbolic link that\
+            \ is the target of the symbolic link."
+          example: /Documents/Users/aspera
+        basename:
+          type: string
+          description: The base name of the symbolic link target.
+          example: sample.txt
+        type:
+          type: string
+          description:
+            "The type of the symbolic link target. Value is \"file\", \"\
+            directory\", or \"symbolic_link\"."
+          example: file
+        size:
+          type: integer
+          description:
+            "The size of the file or symbolic link, in bytes. Directory\
+            \ size is reported as 0."
+          example: 108323953
+        mtime:
+          type: string
+          description: "The symbolic link target's modification time, in ISO format."
+          example: 2011-01-31 11:59:59
+        permissions:
+          type: array
+          items:
+            $ref: "#/components/schemas/filesBrowsePermissions"
+      description:
+        JSON object that contains the metadata associated with the symbolic
+        link target.
+    files-create-post-request:
+      required:
+        - paths
+      type: object
+      properties:
+        paths:
+          type: array
+          description:
+            "Array containing the paths of the files, directories, and\
+            \ symbolic links to create."
+          items:
+            $ref: "#/components/schemas/files-create-path"
+    files-create-path:
+      required:
+        - path
+        - type
+      type: object
+      properties:
+        path:
+          type: string
+          description: The pathname for the new item.
+        type:
+          type: string
+          description:
+            "The type of item to create. Values are file, directory, or\
+            \ symbolic_link."
+        target:
+          $ref: "#/components/schemas/files-create-target"
+        contents:
+          type: string
+          description: base64 encoded contents of the file to be created.
+    files-create-target:
+      required:
+        - path
+      type: string
+      properties:
+        path:
+          type: string
+          description: The pathname of the target for the new symbolic link.
+      description:
+        Required when 'type' is "symbolic_link'. JSON containing the target
+        pathname.
+    files-create-post-200:
+      type: object
+      properties:
+        paths:
+          type: array
+          description: JSON object that lists the pathnames created by the request.
+          items:
+            $ref: "#/components/schemas/files-create-response-path"
+    files-create-response-path:
+      type: object
+      properties:
+        path:
+          type: string
+          description: The new item pathname.
+        error:
+          $ref: "#/components/schemas/files-create-error"
+    files-create-error:
+      type: object
+      properties:
+        code:
+          type: integer
+          description: HTTP error code number.
+          example: 409
+        reason:
+          type: string
+          description: Short error description.
+          example: Conflict
+        user_message:
+          type: string
+          description: Longer error description.
+          example: Path already exists
+      description: JSON object describing an error.
+    files-delete-post-request:
+      required:
+        - paths
+      type: object
+      properties:
+        paths:
+          type: array
+          description: Array of full paths to the files and directories to delete.
+          items:
+            $ref: "#/components/schemas/files-delete-path"
+    files-delete-path:
+      required:
+        - path
+      type: object
+      properties:
+        path:
+          type: string
+          description: The full path to the file or directory to delete.
+        recursive_delete:
+          type: boolean
+          description:
+            "Set the behavior for deleting non-empty directories. If true\
+            \ (default), delete directories even if they are non-empty. Set to false\
+            \ to not delete non-empty directories and return an error."
+    files-delete-post-200:
+      type: object
+      properties:
+        paths:
+          type: array
+          description:
+            JSON array of full paths to the files and directories in the
+            request body.
+          items:
+            $ref: "#/components/schemas/files-delete-response-path"
+    files-delete-response-path:
+      type: object
+      properties:
+        path:
+          type: string
+          description: The deleted item pathname.
+        error:
+          $ref: "#/components/schemas/files-delete-error"
+    files-delete-error:
+      type: object
+      properties:
+        code:
+          type: integer
+          description: HTTP error code number.
+          example: 500
+        reason:
+          type: string
+          description: Short error description.
+          example: Not Found
+        user_message:
+          type: string
+          description: Longer error description.
+          example: No such file or directory
+      description: "JSON object describing an error, if any."
+    files-download_setup-post-request:
+      required:
+        - transfer_requests
+      type: object
+      properties:
+        transfer_requests:
+          type: array
+          description:
+            "The JSON object that contains the transfer request information.\
+            \ Multiple transfer requests can be included as comma-delimited transfer_request\
+            \ objects, if needed."
+          items:
+            $ref: "#/components/schemas/token-transfer-request"
+    token-transfer-request:
+      required:
+        - transfer_request
+      type: object
+      properties:
+        transfer_request:
+          $ref: "#/components/schemas/token-transfer-request-body"
+    token-transfer-request-body:
+      type: object
+      properties:
+        source_root:
+          type: string
+          description: The source root directory of the files.
+          example: /Users/aspera
+        destination_root:
+          type: string
+          description: The destination root directory.
+        token_life_seconds:
+          type: integer
+          description:
+            "How long the token is valid after creation, in seconds. This\
+            \ option overrides the server setting."
+          example: 43200
+        paths:
+          type: array
+          description:
+            "Array of source or destination paths. For uploads, either\
+            \ a value must be provided for \"destination_root\" or at least one \"\
+            destination\" must be set in \"paths\". Set \"destination\" as \"*\" to\
+            \ allow uploads to the \"destination_root\" itself or any directories\
+            \ within it. For downloads, either a value must be provided for \"source_root\"\
+            \ or at least one \"source\" must be set in \"paths\". Set \"source\"\
+            \ as * to allow downloads of the \"source_root\" itself or any files within\
+            \ it."
+          items:
+            $ref: "#/components/schemas/token-paths"
+        remote_host:
+          type: string
+          description: IP or fully qualified domain name of the remote server
+          example: 10.0.0.1
+        cipher_allowed:
+          type: string
+          description:
+            "The algorithm that is used to encrypt data during a transfer.\
+            \ Use this option when transmitting sensitive data. Allowed values: none,\
+            \ \"aes-128\", \"aes-256\". Default: none."
+          example: aes-128
+        content_protection:
+          type: string
+          description:
+            "Enable content protection (encryption-at-rest), which encrypts\
+            \ files when they are uploaded to the server and decrypts files when they\
+            \ are downloaded. Allowed values:  encrypt: Encrypt transferred files\
+            \ (on the server). decrypt: Decrypt downloaded files. If content_protection_password\
+            \ is not specified, Connect will prompt for the passphrase.  Default:\
+            \ decrypt"
+          example: decrypt
+        content_protection_password:
+          type: string
+          description:
+            Password to apply or remove encryption. Must be provided when
+            "content_protection" is enabled.
+        cookie:
+          type: string
+          description:
+            "Metadata to associate with the transfer. The cookie is reported\
+            \ to both client-side and server-side applications that are monitoring\
+            \ FASP transfers. Default: none"
+        fasp_port:
+          type: integer
+          description:
+            "The UDP port for FASP to use. The default value works for\
+            \ most situations; however, it can be changed to satisfy firewall requirements.\
+            \ Default: 33001"
+          example: 33001
+        ssh_port:
+          type: integer
+          description:
+            "The server's TCP port that is listening for SSH connections.\
+            \ FASP® initiates transfers through SSH. Default value: 33001"
+          example: 22
+        http_fallback:
+          type: boolean
+          description:
+            "If set to true, the transfer attempts an HTTP or HTTPS transfer\
+            \ if FASP transfer errors. Default: false."
+          example: false
+        http_fallback_port:
+          type: integer
+          description:
+            "The port that is used for HTTP transfers. If a cipher is enabled,\
+            \ the default is 443; otherwise, the default is 80."
+          example: 443
+        https_fallback_port:
+          type: integer
+          description:
+            "The port that is used for HTTPS transfers. If a cipher is\
+            \ enabled, the default is 443; otherwise, the default is 80."
+          example: 443
+        rate_policy_allowed:
+          type: string
+          description:
+            The most aggressive rate policy that is allowed for the transfer.
+            See "rate_policy" for values.
+          example: high
+        rate_policy:
+          type: string
+          description:
+            "The congestion control behavior to use when sharing bandwidth.\
+            \ Allowed values:  high: When sharing bandwidth, transfer at twice the\
+            \ rate of a transfer using a fair policy. fair (default value): Share\
+            \ bandwidth equally with other traffic. low: Use only un-utilized bandwidth.\
+            \ fixed: Transfer at the target rate, regardless of the actual network\
+            \ capacity. Do not share bandwidth. The fixed policy can decrease transfer\
+            \ performance and cause problems on the target storage."
+          example: fair
+        target_rate_kbps:
+          type: integer
+          description:
+            "The desired speed of the transfer, in Kbps. If there is competing\
+            \ network traffic, FASP shares this bandwidth, depending on the \"rate_policy\"\
+            . Default is set on the server in the configuration file (aspera.conf).\
+            \ Will respect both local- and server-side target rate caps if set. Must\
+            \ be provided when you set a value for \"target_rate_cap_kbps\"."
+          example: 10000
+        target_rate_cap_kbps:
+          type: integer
+          description: "Upper limit of target rate, in Kbps. Default: no limit"
+          example: 12000
+        tags:
+          $ref: "#/components/schemas/transferRequestAsperaTags"
+        aspera_connect_settings:
+          type: string
+          description: "For more information on Connect settings, see Transfer Specifications."
+    token-paths:
+      type: object
+      properties:
+        source:
+          type: string
+          description:
+            "The path for the source file or directory, relative to the\
+            \ source root."
+        destination:
+          type: string
+          description:
+            "Destination path for the file or directory being transferred,\
+            \ relative to the destination root."
+      description: "For uploads and downloads, a source must be included in each path. The destination is optional only when a “destination_root” is provided. The “source_root” is always optional."
+    files-download_setup-post-200:
+      type: object
+      properties:
+        transfer_specs:
+          type: array
+          description:
+            An array of transfer specifications that are allowed by the
+            specified tokens.
+          items:
+            $ref: "#/components/schemas/token-transfer-spec"
+    token-transfer-spec:
+      type: object
+      properties:
+        transfer_spec:
+          $ref: "#/components/schemas/token-transfer-spec-body"
+    token-transfer-spec-body:
+      type: object
+      properties:
+        paths:
+          type: array
+          description:
+            "Array of JSON objects containing source and, if specified,\
+            \ destination paths."
+          items:
+            $ref: "#/components/schemas/paths"
+        source_root:
+          type: string
+          description: The source root directory of the files.
+          example: /Users/aspera
+        destination_root:
+          type: string
+          description: The destination root directory.
+          example: /projects/images
+        token:
+          type: string
+          description: The token string.
+          example: ATB2_ACsjPbserJSER32u-FHp6BsERNE3834UgE_2BTA
+        direction:
+          type: string
+          description:
+            "For downloads, the value is receive. For uploads, the value\
+            \ is send."
+        cipher:
+          type: string
+          description:
+            The weakest cipher that is allowed for the transfer. Value
+            can be "none" or "aes-128".
+          example: aes-128
+        tags:
+          $ref: "#/components/schemas/transferRequestAsperaTags"
+        rate_policy_allowed:
+          type: string
+          description:
+            The most aggressive rate policy that is allowed for the transfer.
+            See rate_policy for values.
+          example: high
+        rate_policy:
+          type: string
+          description:
+            "The congestion control behavior to use when sharing bandwidth.\
+            \ Allowed values:  high: When sharing bandwidth, transfer at twice the\
+            \ rate of a transfer using a fair policy. fair (default value): Share\
+            \ bandwidth equally with other traffic. low: Use only un-utilized bandwidth.\
+            \ fixed: Transfer at the target rate, regardless of the actual network\
+            \ capacity. Do not share bandwidth. The fixed policy can decrease transfer\
+            \ performance and cause problems on the target storage."
+          example: fair
+        target_rate_kbps:
+          type: integer
+          description: "The desired speed of the transfer, in Kbps."
+          example: 10000
+        min_rate_kbps:
+          type: integer
+          description: "The minimum transfer rate, in Kbps."
+          example: 0
+        remote_host:
+          type: string
+          description: IP or fully qualified domain name of the remote server
+          example: 10.0.0.1
+        remote_user:
+          type: string
+          description:
+            "The system user that authenticates the SSH connection for\
+            \ the transfer, derived from the request authentication method."
+          example: xfer
+        sshfp:
+          type: string
+          description:
+            "The node's SSH fingerprint, if it is configured in the node's\
+            \ aspera.conf."
+        ssh_port:
+          type: integer
+          description:
+            "The server's TCP port that is listening for SSH connections.\
+            \ FASP® initiates transfers through SSH. Default value: 33001"
+          example: 22
+        fasp_port:
+          type: integer
+          description:
+            "The UDP port for FASP to use. The default value works for\
+            \ most situations; however, it can be changed to satisfy firewall requirements.\
+            \ Default: 33001"
+          example: 33001
+        http_fallback:
+          type: boolean
+          description:
+            "If set to true, the transfer attempts an HTTP or HTTPS transfer\
+            \ if FASP transfer errors. Default: false."
+          example: false
+        https_fallback_port:
+          type: integer
+          description:
+            "The port that is used for HTTPS transfers. If a cipher is\
+            \ enabled, the default is 443; otherwise, the default is 80."
+          example: 443
+      description: The transfer specification.
+    transferRequestAsperaTags:
+      type: object
+      properties:
+        xfer_retry:
+          type: integer
+          description: Override for ascp's --retry-timeout option
+        usage_id:
+          type: string
+          description:
+            Assign a usage ID to the transfer in order to query transfer
+            usage (bytes transferred) with the /usage endpoint.
+    files-info-post-request:
+      required:
+        - paths
+      type: object
+      properties:
+        paths:
+          type: array
+          description: A JSON object that specifies an array of paths.
+          items:
+            $ref: "#/components/schemas/files-info-request-path"
+    files-info-request-path:
+      required:
+        - path
+      type: object
+      properties:
+        path:
+          type: string
+          description: The path name. Metadata is returned for each path.
+          example: /documents/user/file1.txt
+    files-info-post-200:
+      type: object
+      properties:
+        paths:
+          type: array
+          description: The array of paths
+          example:
+            - path: /Users/aspera/Documents
+              basename: Documents
+              type: directory
+              size: 0
+              mtime: 2018-03-01T22:56:14Z
+              permissions:
+                - name: view
+                - name: edit
+                - name: delete
+            - path: /Users/aspera/Documents/sample.txt
+              basename: sample.txt
+              type: file
+              size: 445
+              mtime: 2018-02-09T23:08:46Z
+              permissions:
+                - name: view
+                - name: edit
+                - name: delete
+            - path: /Users/aspera/Documents/symlink1
+              basename: symlink1
+              type: file
+              size: 445
+              mtime: 2018-02-09T23:08:46Z
+              permissions:
+                - name: view
+                - name: edit
+                - name: delete
+            - path: /Users/aspera/Documents/missing_file.txt
+              error:
+                code: 404
+                reason: Not Found
+                user_message: Path not found
+          items:
+            $ref: "#/components/schemas/files-info-metadata"
+    files-info-metadata:
+      type: object
+      properties:
+        path:
+          type: string
+          description: The pathname.
+          example: /documents/user/file1.txt
+        basename:
+          type: string
+          description: The base name of the item.
+          example: file1.txt
+        type:
+          type: string
+          description:
+            "The type of item: \"file\" (for files and symbolic links)\
+            \ or \"directory\""
+          example: file
+        size:
+          type: integer
+          description: The size of the file. Size is not reported for directories.
+          example: 455
+        mtime:
+          type: string
+          description: The modification time of the file in ISO format.
+          example: 2018-02-09T23:08:46Z
+        permissions:
+          type: array
+          description:
+            "An array of permissions that the user has for the item. Permissions\
+            \ values are \"view\", \"edit\", and \"delete\"."
+          items:
+            $ref: "#/components/schemas/gen3-permissions"
+        error:
+          $ref: "#/components/schemas/files-delete-error"
+    gen3-permissions:
+      type: object
+      properties:
+        name:
+          type: string
+          description:
+            "The permission granted to the user for the file. Value is\
+            \ \"view\", \"edit\", or \"delete\"."
+          example: view
+    files-rename-post-request:
+      required:
+        - paths
+      type: object
+      properties:
+        paths:
+          type: array
+          description:
+            "A JSON array of the files, symbolic links, and directories\
+            \ to rename."
+          example:
+            - path: /full/path/to/parent/dir
+              source: old_dir_name
+              destination: new_dir_name
+            - path: /full/path/to/parent/dir
+              source: old_file_name
+              destination: new_file_name
+          items:
+            $ref: "#/components/schemas/files-rename-post-path"
+    files-rename-post-path:
+      required:
+        - destination
+        - path
+        - source
+      type: object
+      properties:
+        path:
+          type: string
+          description:
+            "The full path to the parent directory of the file, symbolic\
+            \ link, or directory to rename."
+          example: /documents/folder/
+        source:
+          type: string
+          description: "The current name of the file, symbolic link, or directory."
+          example: old_file_name.txt
+        destination:
+          type: string
+          description: "The new name for the file, symbolic link, or directory."
+          example: new_file_name.txt
+    files-rename-post-200:
+      type: object
+      properties:
+        paths:
+          type: array
+          description: "A JSON array of the renamed files, symbolic links, and directories."
+          items:
+            $ref: "#/components/schemas/files-rename-response-path"
+    files-rename-response-path:
+      type: object
+      properties:
+        path:
+          type: string
+          description:
+            "The full path to the parent directory of the file, symbolic\
+            \ link, or directory to rename."
+          example: /documents/folder/
+        source:
+          type: string
+          description: "The current name of the file, symbolic link, or directory."
+          example: old_file_name.txt
+        destination:
+          type: string
+          description: "The new name for the file, symbolic link, or directory."
+          example: new_file_name.txt
+        error:
+          $ref: "#/components/schemas/files-delete-error"
+    files-upload_setup-post-request:
+      required:
+        - transfer_requests
+      type: object
+      properties:
+        transfer_requests:
+          type: array
+          description:
+            "The JSON object that contains the transfer request information.\
+            \ Multiple transfer requests can be included as comma-delimited \"transfer_request\"\
+            \ objects, if needed."
+          items:
+            $ref: "#/components/schemas/token-transfer-request"
+    files-upload_setup-post-200:
+      type: object
+      properties:
+        transfer_specs:
+          type: array
+          description:
+            An array of transfer specifications that are allowed by the
+            specified tokens.
+          items:
+            $ref: "#/components/schemas/token-transfer-spec"
+    paths:
+      required:
+        - source
+      type: object
+      properties:
+        source:
+          type: string
+          description:
+            "The path for the source file or directory, relative to the\
+            \ source root."
+        destination:
+          type: string
+          description:
+            "Destination path for the file or directory that is being transferred,\
+            \ relative to the destination root. If no destination is specified, the\
+            \ content is transferred to the destination root."
+      description: "The source paths, and optional destination paths, for the transfer."
+    space-post-request:
+      required:
+        - paths
+      type: object
+      properties:
+        paths:
+          type: array
+          description: An array of paths.
+          items:
+            $ref: "#/components/schemas/space-post-request-path"
+    space-post-request-path:
+      required:
+        - path
+      type: object
+      properties:
+        path:
+          type: string
+          description:
+            The path name. Space information is returned for the mount
+            point of the path.
+    space-post-200:
+      type: object
+      properties:
+        paths:
+          type: array
+          items:
+            $ref: "#/components/schemas/space-paths"
+    space-paths:
+      type: object
+      properties:
+        path:
+          type: string
+          description: The path name that was queried.
+        bytes_total:
+          type: integer
+          description: The total space in bytes of the mount point of the path.
+        bytes_free:
+          type: integer
+          description: The free space in bytes of the mount point of the path.
+        percent_free:
+          type: number
+          description: The percentage of the total space that is available.
+    error:
+      type: object
+      properties:
+        error:
+          $ref: "#/components/schemas/errorBody"
+      description: The error response object.
+    errorBody:
+      type: object
+      properties:
+        code:
+          type: integer
+          description: The HTTP error code.
+        reason:
+          type: string
+          description: The HTTP error message.
+        user_message:
+          type: string
+          description: A longer error description.
+      description: The contents of the error response object.
+  responses:
+    BadRequest:
+      description: Bad request - invalid parameters
+      content:
+        application/json:
+          schema:
+            $ref: "#/components/schemas/Error"
+          example:
+            error:
+              user_message: Invalid request parameters
+    Unauthorized:
+      description: Unauthorized - authentication required
+      content:
+        application/json:
+          schema:
+            $ref: "#/components/schemas/Error"
+          example:
+            error:
+              user_message: Authentication credentials were not provided or are invalid
+    Forbidden:
+      description: Forbidden - insufficient permissions
+      content:
+        application/json:
+          schema:
+            $ref: "#/components/schemas/Error"
+          example:
+            error:
+              user_message: You do not have permission to perform this action
+    NotFound:
+      description: Not found - resource does not exist
+      content:
+        application/json:
+          schema:
+            $ref: "#/components/schemas/Error"
+          example:
+            error:
+              user_message: The requested resource was not found