Add OpenAPI docs for email verification endpoint

arkindex/users/api.py

@@ -186,6 +186,35 @@ class UserEmailLogin(CreateAPIView):
 
 
 class UserEmailVerification(APIView):
+    """
+    Verify a user's email address
+    """
+
+    openapi_overrides = {
+        'operationId': 'VerifyEmail',
+        'tags': ['users'],
+        'parameters': [
+            {
+                'name': 'email',
+                'in': 'query',
+                'description': 'E-mail to verify',
+                'required': True,
+                'schema': {
+                    'type': 'string',
+                    'format': 'email',
+                },
+            },
+            {
+                'name': 'token',
+                'in': 'query',
+                'description': 'Verification token',
+                'required': True,
+                'schema': {
+                    'type': 'string',
+                },
+            },
+        ],
+    }
 
     def get(self, *args, **kwargs):
         if not all(arg in self.request.GET for arg in ('email', 'token')):