From b680b8e73e61d0b18c4dde35f6306674480ddd62 Mon Sep 17 00:00:00 2001
From: mitrikov <j6p@bk.ru>
Date: Tue, 9 Jun 2026 17:01:51 +1200
Subject: [PATCH] =?UTF-8?q?feat:=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8?=
 =?UTF-8?q?=D0=BB=20=D0=B8=D0=BD=D1=84=D1=83=20=D0=BF=D0=BE=20=D0=BE=D1=82?=
 =?UTF-8?q?=D0=BA=D1=80=D1=8B=D1=82=D0=BA=D0=B0=D0=BC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 v2/swagger.yaml | 55 +++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 53 insertions(+), 2 deletions(-)

diff --git a/v2/swagger.yaml b/v2/swagger.yaml
index db39345..f520e8e 100644
--- a/v2/swagger.yaml
+++ b/v2/swagger.yaml
@@ -1744,6 +1744,54 @@ paths:
         500:
           description: Server Error
 
+  /user-postcard/seen:
+    post:
+      tags:
+        - postcard
+      summary: Mark received postcard as opened
+      operationId: userPostcardSeen
+      parameters:
+        - name: id
+          in: query
+          description: UserPostcard item ID
+          schema:
+            type: string
+            format: uuid
+          required: true
+      responses:
+        200:
+          description: Postcard marked as opened
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                    example: true
+                  data:
+                    type: object
+                    nullable: true
+                    example: null
+                  errors:
+                    type: object
+                    nullable: true
+                    example: null
+                  message:
+                    type: object
+                    nullable: true
+                    example: null
+        400:
+          description: Invalid input (malformed id)
+        401:
+          description: Unauthorized request
+        403:
+          description: Unauthorized request
+        404:
+          description: Postcard not found
+        500:
+          description: Server Error
+
   /article/news:
     get:
       tags:
@@ -9175,7 +9223,10 @@ components:
           type: string
         is_seen:
           type: boolean
-          description: Did user seen this postcard?
+          description: Whether the recipient has opened this postcard.
+        needShowEnvelope:
+          type: boolean
+          description: Whether the mobile app should show the unopened postcard envelope.
 
     userGroup:
       type: object
@@ -13898,4 +13949,4 @@ components:
 security:
   - SessionAuth: [ ]
   - ApiKeyAuth: [ ]
-  - BearerAuth: [ ]
\ No newline at end of file
+  - BearerAuth: [ ]
-- 
2.54.0