docs fix

interface/api/recipients/archive.yaml

@@ -1,6 +1,7 @@
 get:
   tags: [Recipients]
   summary: Archive/unarchive recipient
+  description: Sets recipient archive state by `recipients_ref` and required `archived` query parameter.
   operationId: recipientsArchive
   security:
     - bearerAuth: []
@@ -10,6 +11,7 @@ get:
     - name: archived
       in: query
       required: true
+      description: Target archive value to set on the recipient.
       schema:
         type: boolean
     - $ref: ../parameters/cascade.yaml#/components/parameters/Cascade

interface/api/recipients/create.yaml

@@ -1,6 +1,7 @@
 post:
   tags: [Recipients]
   summary: Create recipient
+  description: Creates a recipient inside the organization identified by `org_ref`.
   operationId: recipientsCreate
   security:
     - bearerAuth: []

interface/api/recipients/list.yaml

@@ -1,6 +1,9 @@
 get:
   tags: [Recipients]
   summary: List recipients
+  description: |
+    Returns recipients for the specified organization context.
+    Supports offset pagination and optional archive filtering.
   operationId: recipientsList
   security:
     - bearerAuth: []

interface/api/recipients/object.yaml

@@ -1,6 +1,7 @@
 get:
   tags: [Recipients]
   summary: Get recipient by reference
+  description: Returns a recipient by `recipients_ref`.
   operationId: recipientsGet
   security:
     - bearerAuth: []
@@ -32,6 +33,7 @@ get:
 delete:
   tags: [Recipients]
   summary: Delete recipient
+  description: Deletes recipient by reference. Use `cascade=true` to remove dependent objects when supported.
   operationId: recipientsDelete
   security:
     - bearerAuth: []

interface/api/recipients/update.yaml

@@ -1,6 +1,7 @@
 put:
   tags: [Recipients]
   summary: Update recipient
+  description: Updates recipient fields from request payload.
   operationId: recipientsUpdate
   security:
     - bearerAuth: []