swagger.io icon indicating copy to clipboard operation
swagger.io copied to clipboard

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

Open thernstig opened this issue 3 years ago • 1 comments

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.

thernstig avatar Jun 23 '21 19:06 thernstig

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.

hkosova avatar Jun 23 '21 19:06 hkosova