The description Invalid Input of 405 Responses Object is ambiguous and leads to misunderstanding

[weimengxi]

As the document says, the key of a responses object's Patterned Fields is Http Status Code .

and the document gives responses object examples like this at following part.

  "responses": {
    "405": {
      "description": "Invalid input",
      "content": {
        "application/json": {},
        "application/xml": {}
      }
    }
  }

As it defined in rfc7231 Specification , 405 indicates Method Not Allowed rather than Invalid Input .

The 405 (Method Not Allowed) status code indicates that the method
received in the request-line is known by the origin server but not
supported by the target resource.

I think we'd better follow the rfc7231 Specification 's definition

[weimengxi]

Pull Request #1450

[MikeRalphson]

#1486 has been merged, many thanks again.