Add releaseTokenToMailbox API

This is typically only called by the browser -- but it's still handled as
OpenAPI in the controller.

Author: arielshaqed

api/swagger.yml

@@ -2108,6 +2108,15 @@ components:
         destination:
           $ref: "#/components/schemas/IcebergLocalTable"
 
+    ReleaseToken:
+      type: object
+      required:
+        - token
+      properties:
+        token:
+          type: string
+          description: Login request token to release
+
 paths:
   /setup_comm_prefs:
     post:
@@ -3244,6 +3253,33 @@ paths:
         default:
           $ref: "#/components/responses/ServerError"
 
+  /auth/get-token/release-token:
+    post:
+      tags:
+        - auth
+        - experimental
+      operationId: releaseTokenToMailbox
+      summary: release a token for the current (authenticated) user to the mailbox of this login request.
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/ReleaseToken"
+      responses:
+        204:
+          description: token released
+        401:
+          description: bad token or user has not logged in yet
+          $ref: "#/components/responses/Unauthorized"
+        429:
+          description: too many requests
+        501:
+          description: not implemented in this edition.
+          $ref: "#/components/responses/NotImplemented"
+        default:
+          $ref: "#/components/responses/ServerError"
+
   /repositories:
     get:
       tags: