--- a/mod_rest/res/openapi.yaml	Wed Feb 22 22:47:45 2023 -0500
+++ b/mod_rest/res/openapi.yaml	Sat May 06 19:40:23 2023 -0500
@@ -21,6 +21,7 @@
       security:
         - basic: []
         - token: []
+        - oauth2: []
       requestBody:
         $ref: '#/components/requestBodies/common'
       responses:
@@ -37,6 +38,7 @@
       security:
       - basic: []
       - token: []
+      - oauth2: []
       parameters:
       - $ref: '#/components/parameters/kind'
       - $ref: '#/components/parameters/type'
@@ -55,6 +57,7 @@
       security:
         - basic: []
         - token: []
+        - oauth2: []
       requestBody:
         $ref: '#/components/requestBodies/common'
       responses:
@@ -69,6 +72,7 @@
       security:
       - basic: []
       - token: []
+      - oauth2: []
       parameters:
       - $ref: '#/components/parameters/to'
       responses:
@@ -91,6 +95,7 @@
       security:
       - basic: []
       - token: []
+      - oauth2: []
       parameters:
       - $ref: '#/components/parameters/to'
       responses:
@@ -112,6 +117,7 @@
       security:
       - basic: []
       - token: []
+      - oauth2: []
       parameters:
       - $ref: '#/components/parameters/to'
       responses:
@@ -126,6 +132,7 @@
       security:
       - basic: []
       - token: []
+      - oauth2: []
       parameters:
       - $ref: '#/components/parameters/to'
       responses:
@@ -140,6 +147,7 @@
       security:
       - basic: []
       - token: []
+      - oauth2: []
       parameters:
       - $ref: '#/components/parameters/to'
       - name: type
@@ -160,6 +168,7 @@
       security:
       - basic: []
       - token: []
+      - oauth2: []
       parameters:
       - $ref: '#/components/parameters/to'
       - name: with
@@ -211,6 +220,7 @@
       security:
       - basic: []
       - token: []
+      - oauth2: []
       parameters:
       - $ref: '#/components/parameters/to'
       responses:
@@ -225,6 +235,7 @@
       security:
       - basic: []
       - token: []
+      - oauth2: []
       parameters:
       - $ref: '#/components/parameters/to'
       responses:
@@ -239,6 +250,7 @@
       security:
       - basic: []
       - token: []
+      - oauth2: []
       parameters:
       - $ref: '#/components/parameters/to'
       responses:
@@ -1411,6 +1423,18 @@
       description: Use JID as username.
       scheme: Basic
       type: http
+    oauth2:
+      description: Needs mod_http_oauth2
+      type: oauth2
+      flows:
+        authorizationCode:
+          authorizationUrl: https://example.com/oauth2/authorize
+          tokenUrl: https://example.com/oauth2/token
+          scopes:
+            prosody:restricted: Restricted account
+            prosody:user: Regular user privileges
+            prosody:admin: Administrator privileges
+            prosody:operator: Server operator privileges
 
   requestBodies:
     common: