docs: def get_swagger_operation(self, context=default_context):
          """
          get the swagger_schema operation representation.
          """
          consumes = produces = context.contenttype_serializers.keys()
          parameters = get_swagger_parameters(self.parameters, context)
          responses = {
              "400": Response(
                  {
                      "description": "invalid input received",
                      "schema": Schema(
                          {
                              "title": "FailureObject",
                              "type": "object",
                              "properties": {
                                  "success": {"type": "boolean"},
                                  "result": {"type": "string"},
                              },
                              "required": ["success", "result"],
                          }
                      ),
                  }
              )
          }
  
          for code, details in self.response_types.items():
              responses[str(code)] = details.swagger_definition(context)
  
          return Operation(
              {
                  "summary": self.summary,
                  "description": self.description,
                  "consumes": consumes,
                  "produces": produces,
                  "parameters": parameters,
                  "responses": responses,
                  "operationId": self.raw_func.__name__,
                  "tags": self.tags,
              }
          )