Callbacks service docs updated

interface/api/accounts/bodies/auth.yaml

@@ -1,12 +1,14 @@
 components:
   requestBodies:
     LoginBody:
+      description: JSON credentials payload for standard login.
       required: true
       content:
         application/json:
           schema:
             $ref: ../request/auth.yaml#/components/schemas/LoginRequest
     ApiLoginBody:
+      description: JSON credentials payload for API client login.
       required: true
       content:
         application/json:
@@ -14,6 +16,7 @@ components:
             $ref: ../request/auth.yaml#/components/schemas/ApiLoginRequest
 
     RefreshTokenBody:
+      description: JSON payload containing session and refresh token data.
       required: true
       content:
         application/json:

interface/api/accounts/request/auth.yaml

@@ -11,6 +11,7 @@ components:
           description: Client identifier bound to refresh token lifecycle and client policy checks.
         deviceId:
           type: string
+          description: Device/server identifier associated with the client session.
         login:
           $ref: ../../../models/auth/login_data.yaml#/components/schemas/LoginData
 

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