Parsing swagger-spec copies responses.200.schema into property responses.200.responseSchema?

Here is an example of an endpoint with the schema property being copied.

	"post": {
		"tags": [
			"users"
		],
		"consumes": [
			"application/x-www-form-urlencoded"
		],
		"produces": [
			"application/xml",
			"application/json"
		],
		"parameters": [
			{
				"name": "userId",
				"in": "path",
				"description": "the ID of the user",
				"required": true,
				"type": "string"
			},
			{
				"name": "AuthToken",
				"in": "header",
				"description": "Authentication token",
				"required": true,
				"type": "string"
			}
		],
		"responses": {
			"200": {
				"description": "Successful operation",
				"schema": {
					"$ref": "#/definitions/GameUsage"
				}
			},
			"400": {
				"description": "Invalid status value"
			}
		}
	}
}

is transformed into

"/users" : {
      "post" : {
        "tags" : [ "users" ],
        "consumes" : [ "application/x-www-form-urlencoded" ],
        "produces" : [ "application/xml", "application/json" ],
        "parameters" : [ {
          "name" : "userId",
          "in" : "path",
          "description" : "the ID of the user",
          "required" : true,
          "type" : "string"
        },
		{
          "name" : "AuthToken",
          "in" : "header",
          "description" : "Authentication token",
          "required" : true,
          "type" : "string"
        } ],
        "responses" : {
          "200" : {
            "description" : "Successful operation",
            "responseSchema" : {
              "$ref" : "#/definitions/GameUsage"
            },
            "schema" : {
              "$ref" : "#/definitions/GameUsage"
            }
          },
          "400" : {
            "description" : "Invalid status value"
          }
        }
      }
    }

[frantuma]

You have two options:

1. either use the configured mapper provided by swagger-core via io.swagger.v3.core.util.Json.mapper() (or Yaml.mapper()) and if needed customize it further e.g with SerializationFeature.INDENT_OUTPUT

2. add the following to your mapper config: mapper.addMixIn(Response.class, ResponseSchemaMixin.class);

[gracekarina]

Glad to see your issue is solved. About the ResponseSchemaMixin, it establishes the responseSchema attribute as the schema property. This is part of a change made in core to support Model in the schema attribute which was previously a property. https://github.com/swagger-api/swagger-core/blob/1.5/modules/swagger-core/src/main/java/io/swagger/jackson/mixin/ResponseSchemaMixin.java