docs fix

interface/api/verification/create.yaml

@@ -1,6 +1,9 @@
 post:
   tags: [Verification, Auth]
   summary: Request verification code
+  description: |
+    Creates a verification challenge for the specified purpose/target.
+    For `purpose=login`, request must be authorized with a pending account token.
   operationId: verificationRequestCode
   security:
     - bearerAuth: []

interface/api/verification/request/verification.yaml

@@ -5,7 +5,6 @@ components:
       additionalProperties: false
       required:
         - purpose
-        - idempotencyKey
       properties:
         purpose:
           type: string

interface/api/verification/resend.yaml

@@ -1,6 +1,9 @@
 post:
   tags: [Verification, Auth]
   summary: Resend verification code
+  description: |
+    Re-issues a verification challenge using the same request shape as `/verification`.
+    Cooldown and retry limits are enforced by backend verification storage policy.
   operationId: verificationResendCode
   security:
     - bearerAuth: []

interface/api/verification/verify.yaml

@@ -1,6 +1,9 @@
 post:
   tags: [Verification, Auth]
   summary: Verify code and complete pending flow
+  description: |
+    Verifies submitted code and consumes verification token.
+    For login purpose, returns full auth payload (access + refresh tokens); for other purposes returns operation result.
   operationId: verificationVerifyCode
   security:
     - bearerAuth: []