I want to document a multipart request like the following: Content-Length: 477 Content-Type: multipart/form-data; boundary=---BOUNDARY -----BOUNDARY Content-Disposition: form-data; name="image[fi...

I want to specify the various exceptions/errors that have to be returned while making an API call. How do I achieve this with Apiary.

I am trying out API Blueprint and found some things, which are not quite clear to me. 1. How can I document POST body parameters? There is + Parameters but it just documents query parameters. If ...

In API blueprint I am looking to specify an optional json element for a POST message. Example for; ### Add a new User [POST] To add a User send a JSON ..... + Request (application/json) { "...

We all know that apiary rocks (or not.. I think it does), and I was wondering what would it take to take it a step further allow users to export a JSON description of the API? (So developers can sc...

I'm writing a spec for an API where the fields included in the response vary. I would like to be able to provide more than one example to show this. My use cases are: One of the API calls has an...

thanks for your time I have a POST request that I want to document in the blueprint apiary, the header is something like this: text/html _method:POST data[User][username]: data[User][password]:...

Is it possible to specify description for every response to some request? Suppose, we have a request ### Retrieve resource [GET] + Headers If-None-Match: "Version1" And 2 responses + Respon...