fix #6833

Author: chrisv2

rest_framework/schemas/openapi.py

@@ -483,6 +483,10 @@ def _get_responses(self, path, method):
                 'content': {
                     ct: {'schema': content}
                     for ct in self.content_types
-                }
+                },
+                # description is a mandatory property,
+                # https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#responseObject
+                # TODO: put something meaningful into it
+                'description': ""
             }
         }

tests/schemas/test_openapi.py

@@ -72,7 +72,7 @@ def test_path_without_parameters(self):
         assert operation == {
             'operationId': 'ListExamples',
             'parameters': [],
-            'responses': {'200': {'content': {'application/json': {'schema': {}}}}},
+            'responses': {'200': {'content': {'application/json': {'schema': {}}}, 'description': ''}},
         }
 
     def test_path_with_id_parameter(self):
@@ -143,6 +143,7 @@ class View(generics.GenericAPIView):
         responses = inspector._get_responses(path, method)
         assert responses['200']['content']['application/json']['schema']['required'] == ['text']
         assert list(responses['200']['content']['application/json']['schema']['properties'].keys()) == ['text']
+        assert 'description' in responses['200']
 
     def test_response_body_nested_serializer(self):
         path = '/'