Adds a response to the operation of a swagger %PathObject{}, without a schema.

Adds a response to the operation of a swagger %PathObject{}, with a schema.

Optional keyword args can be provided for headers and examples.

If the mime-type is known from the produces list, then a single can be given as a shorthand.

Examples

get "/users/{id}"
produces "application/json"
parameter :id, :path, :integer, "user id", required: true
response 200, "Success", :User, examples: %{"application/json": %{id: 1, name: "Joe"}}

get "/users/{id}"
produces "application/json"
parameter :id, :path, :integer, "user id", required: true
response 200, "Success", :User, example: %{id: 1, name: "Joe"}