[skip ci] Add swagger.yaml

Author: envision-ci-agent

swagger.yaml

@@ -31572,6 +31572,117 @@ paths:
       summary: Associate the user with the provided Hedera token.
       tags:
         - tokens
+  /tokens/{tokenId}/transfer:
+    post:
+      description: >-
+        Transfers fungible or non-fungible tokens from the authenticated user's
+        Hedera account to the specified target account. For FT, specify amount.
+        For NFT, specify serialNumbers or amount (picks from end).
+      operationId: TokensApi_transferToken
+      parameters:
+        - name: tokenId
+          required: true
+          in: path
+          description: Token ID
+          schema:
+            example: 69aeb71ef8c5b278e3bab4e5
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TransferTokenDTO'
+      responses:
+        '200':
+          description: Successful operation.
+        '401':
+          description: Unauthorized request.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedErrorDTO'
+              example:
+                statusCode: 401
+                message: Unauthorized request
+        '403':
+          description: Forbidden
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ForbiddenErrorDTO'
+              example:
+                message: Forbidden resource
+                error: Forbidden
+                statusCode: 403
+        '500':
+          description: Internal server error.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerErrorDTO'
+      security:
+        - bearer: []
+      summary: Transfers tokens from the authenticated user to the target account.
+      tags:
+        - tokens
+  /tokens/push/{tokenId}/transfer:
+    post:
+      description: >-
+        Transfers fungible or non-fungible tokens asynchronously. Returns a task
+        ID for tracking.
+      operationId: TokensApi_transferTokenAsync
+      parameters:
+        - name: tokenId
+          required: true
+          in: path
+          description: Token ID
+          schema:
+            example: 69aeb71ef8c5b278e3bab4e5
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/TransferTokenDTO'
+      responses:
+        '200':
+          description: Successful operation.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/TaskDTO'
+        '401':
+          description: Unauthorized request.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/UnauthorizedErrorDTO'
+              example:
+                statusCode: 401
+                message: Unauthorized request
+        '403':
+          description: Forbidden
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ForbiddenErrorDTO'
+              example:
+                message: Forbidden resource
+                error: Forbidden
+                statusCode: 403
+        '500':
+          description: Internal server error.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/InternalServerErrorDTO'
+      security:
+        - bearer: []
+      summary: Transfers tokens from the authenticated user to the target account.
+      tags:
+        - tokens
   /tokens/{tokenId}/{username}/grant-kyc:
     put:
       description: >-
@@ -55516,6 +55627,31 @@ components:
         - enableFreeze
         - enableKYC
         - enableWipe
+    TransferTokenDTO:
+      type: object
+      properties:
+        targetAccount:
+          type: string
+          description: Target Hedera account ID
+          example: 0.0.12345
+        amount:
+          type: number
+          description: Amount (FT) or serial count to pick (NFT); must be > 0
+          example: 10
+        serialNumbers:
+          description: Specific NFT serial numbers to transfer; positive integers
+          example:
+            - 1
+            - 2
+            - 3
+          type: array
+          items:
+            type: number
+        memo:
+          type: string
+          description: Optional transaction memo
+      required:
+        - targetAccount
     ThemeRoleDTO:
       type: object
       properties: