Callbacks service docs updated

interface/api/accounts/response/auth.yaml

@@ -1,6 +1,7 @@
 components:
   schemas:
     AccountAuthData:
+      description: Authentication response containing account profile and access token.
       type: object
       additionalProperties: false
       required:
@@ -8,11 +9,14 @@ components:
         - account
       properties:
         accessToken:
+          description: Access token used for authenticated requests.
           $ref: ../../../models/auth/token_data.yaml#/components/schemas/TokenData
         account:
+          description: Authenticated account data.
           $ref: ../../../models/account/account.yaml#/components/schemas/AccountData
 
     LoginData:
+      description: Full login response including access and refresh tokens.
       type: object
       additionalProperties: false
       required:
@@ -21,13 +25,17 @@ components:
         - refreshToken
       properties:
         accessToken:
+          description: Access token used for authenticated requests.
           $ref: ../../../models/auth/token_data.yaml#/components/schemas/TokenData
         account:
+          description: Authenticated account data.
           $ref: ../../../models/account/account.yaml#/components/schemas/AccountData
         refreshToken:
+          description: Refresh token used to obtain a new access token.
           $ref: ../../../models/auth/token_data.yaml#/components/schemas/TokenData
 
     PendingLoginData:
+      description: Pending login response requiring additional verification.
       type: object
       additionalProperties: false
       required:
@@ -36,14 +44,19 @@ components:
         - target
       properties:
         account:
+          description: Interim authentication payload prepared for verification completion.
           type: object
           additionalProperties: false
           properties:
             accessToken:
+              description: Temporary access token issued before verification is completed.
               $ref: ../../../models/auth/token_data.yaml#/components/schemas/TokenData
             account:
+              description: Account data associated with the pending login flow.
               $ref: ../../../models/account/account.yaml#/components/schemas/AccountData
         pendingToken:
+          description: Token proving the pending verification session.
           $ref: ../../../models/auth/token_data.yaml#/components/schemas/TokenData
         target:
+          description: Verification target destination (for example email or phone).
           type: string