From 7b260acd7b3abf8c7b69cc50340c91ac5808a938 Mon Sep 17 00:00:00 2001
From: 6543 <6543@obermui.de>
Date: Sun, 2 Aug 2020 14:01:12 +0200
Subject: [PATCH] Add TOTP header to Swagger Documentation (#12402)

---
 routers/api/v1/api.go          | 6 ++++++
 templates/swagger/v1_json.tmpl | 9 +++++++++
 2 files changed, 15 insertions(+)

diff --git a/routers/api/v1/api.go b/routers/api/v1/api.go
index b03f547a6bc..f67eebacc41 100644
--- a/routers/api/v1/api.go
+++ b/routers/api/v1/api.go
@@ -27,6 +27,7 @@
 //     - AuthorizationHeaderToken :
 //     - SudoParam :
 //     - SudoHeader :
+//     - TOTPHeader :
 //
 //     SecurityDefinitions:
 //     BasicAuth:
@@ -54,6 +55,11 @@
 //          name: Sudo
 //          in: header
 //          description: Sudo API request as the user provided as the key. Admin privileges are required.
+//     TOTPHeader:
+//          type: apiKey
+//          name: X-GITEA-OTP
+//          in: header
+//          description: Must be used in combination with BasicAuth if two-factor authentication is enabled.
 //
 // swagger:meta
 package v1
diff --git a/templates/swagger/v1_json.tmpl b/templates/swagger/v1_json.tmpl
index 28a33fb3d32..c601809a757 100644
--- a/templates/swagger/v1_json.tmpl
+++ b/templates/swagger/v1_json.tmpl
@@ -15551,6 +15551,12 @@
       "name": "sudo",
       "in": "query"
     },
+    "TOTPHeader": {
+      "description": "Must be used in combination with BasicAuth if two-factor authentication is enabled.",
+      "type": "apiKey",
+      "name": "X-GITEA-OTP",
+      "in": "header"
+    },
     "Token": {
       "type": "apiKey",
       "name": "token",
@@ -15575,6 +15581,9 @@
     },
     {
       "SudoHeader": []
+    },
+    {
+      "TOTPHeader": []
     }
   ]
 }