Callbacks service docs updated

interface/models/auth/client_refresh_token.yaml

@@ -1,12 +1,15 @@
 components:
   schemas:
     ClientRefreshToken:
+      description: Refresh token bound to a specific client and device session.
       allOf:
         - $ref: ./session_identifier.yaml#/components/schemas/SessionIdentifier
         - type: object
+          description: Refresh-token payload associated with the session identifier.
           additionalProperties: false
           required:
             - token
           properties:
             token:
+              description: Long-lived token used to obtain a new access token.
               type: string

interface/models/auth/login_data.yaml

@@ -1,6 +1,7 @@
 components:
   schemas:
     LoginData:
+      description: Credentials and optional locale used during user sign-in.
       type: object
       additionalProperties: false
       required:
@@ -8,10 +9,13 @@ components:
         - password
       properties:
         login:
+          description: User login identifier, represented as an email address.
           type: string
           format: email
         password:
+          description: User password submitted for authentication.
           type: string
           format: password
         locale:
+          description: Optional locale preference provided at login time.
           type: string

interface/models/auth/session_identifier.yaml

@@ -1,6 +1,7 @@
 components:
   schemas:
     SessionIdentifier:
+      description: Identifies an authentication session by client and device.
       type: object
       additionalProperties: false
       required:
@@ -8,6 +9,8 @@ components:
         - deviceId
       properties:
         clientId:
+          description: Client application identifier associated with the session.
           type: string
         deviceId:
+          description: Device/server identifier associated with the client session.
           type: string

interface/models/auth/token_data.yaml

@@ -1,6 +1,7 @@
 components:
   schemas:
     TokenData:
+      description: Authentication token payload with expiration metadata.
       type: object
       additionalProperties: false
       required:
@@ -8,7 +9,9 @@ components:
         - expiration
       properties:
         token:
+          description: Issued authentication token value.
           type: string
         expiration:
+          description: RFC 3339 timestamp when the token expires.
           type: string
           format: date-time