Callbacks service docs updated

interface/models/account/account.yaml

@@ -1,12 +1,15 @@
 components:
   schemas:
     AccountData:
+      description: Extended account payload including visibility-specific metadata.
       allOf:
         - $ref: ./account_public.yaml#/components/schemas/AccountPublic
         - type: object
+          description: Account attributes that are not part of the public profile.
           additionalProperties: false
           required:
             - isAnonymous
           properties:
             isAnonymous:
+              description: Indicates whether the account is marked as anonymous.
               type: boolean

interface/models/account/account_public.yaml

@@ -1,10 +1,12 @@
 components:
   schemas:
     AccountPublic:
+      description: Public account profile data exposed in API responses.
       allOf:
         - $ref: ../storable.yaml#/components/schemas/Storable
         - $ref: ../common/describable.yaml#/components/schemas/Describable
         - type: object
+          description: Account-specific public attributes.
           additionalProperties: false
           required:
             - login
@@ -13,14 +15,19 @@ components:
             - isArchived
           properties:
             login:
+              description: Account login identifier represented as an email address.
               type: string
               format: email
             locale:
+              description: Preferred locale used for account-facing content.
               type: string
             lastName:
+              description: Account holder last name.
               type: string
             avatarUrl:
+              description: Optional URL of the account avatar image.
               type: string
               nullable: true
             isArchived:
+              description: Indicates whether the account is archived and inactive.
               type: boolean