From fbf5f413cd5975e24cb6f65ed7836200da2db638 Mon Sep 17 00:00:00 2001
From: Sabine Schaller <sabine@coil.com>
Date: Thu, 7 Jul 2022 11:43:51 +0200
Subject: [PATCH] (feat): spec out interaction endpoints

---
 auth-server-open-api-spec.yaml | 51 ++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/auth-server-open-api-spec.yaml b/auth-server-open-api-spec.yaml
index 42c2b9cc..1ee8549e 100644
--- a/auth-server-open-api-spec.yaml
+++ b/auth-server-open-api-spec.yaml
@@ -16,6 +16,8 @@ tags:
     description: grant operations
   - name: token
     description: token operations
+  - name: interaction
+    description: User interaction endpoints
 paths:
   /:
     post:
@@ -428,6 +430,55 @@ paths:
                   resource_server: 7C7C4AZ9KHRS6X63AJAO
       tags:
         - token
+  '/interact/{id}':
+    get:
+      summary: Start user interaction
+      tags:
+        - interaction
+        - grant
+      responses:
+        '302':
+          description: Found
+          headers:
+            Location:
+              schema:
+                type: string
+              description: Identity server endpoint
+            Cookie:
+              schema:
+                type: string
+              description: Interaction id
+      operationId: get-interact
+      parameters: []
+      description: 'To start the user interaction for grant approval, this endpoint redirects to identity server for authentication of the user.'
+    parameters:
+      - schema:
+          type: string
+        name: id
+        in: path
+        required: true
+        description: Interaction id
+    post:
+      summary: Finish user interaction
+      operationId: post-interact-id
+      responses:
+        '302':
+          description: Found
+          headers:
+            Location:
+              schema:
+                type: string
+              description: Client finish endpoint
+      description: 'To finish the user interaction for grant approval, this endpoint redirects to the client''s finish url.'
+      tags:
+        - interaction
+        - grant
+      parameters:
+        - schema:
+            type: string
+          in: cookie
+          name: interactId
+          description: Interaction id
 components:
   schemas:
     access: