search

swagger-api / swagger.io-docs

The content of swagger.io
https://swagger.io/docs/
1.56k stars 397 forks source link

"Describing parameters" says "Accept" is part of the response when it is not #307

Open thernstig opened 3 years ago

thernstig commented 3 years ago

https://swagger.io/docs/specification/describing-parameters/ check under "Header Parameters" and the table, where it says "Accept". It says it is part of responses.<code>.content.<media-type> and the link in the last column also links to response.

But Accept is part of a request.

hkosova commented 3 years ago

The doc is correct. responses.<code>.content.<media-type> defines both the response's Content-Type header and the request's Accept header. In other words, possible values for the request's Accept header are derived from the defined response media types.