You can already describe URI parameters in structured way with the new API Blueprint format. Refer to https://github.com/apiaryio/api-blueprint/blob/master/examples/7.%20Parameters.md for details.
The new format is now default and URI parameters are properly rendered in the documentation.
We are still working on description of http message–body properties (parameters). It is planned in the upcoming revision 1B of API Blueprint – as discussed in https://github.com/apiaryio/api-blueprint/issues/25Peter T. Brown commented
Just used up all the votes I could for this. Seems like a significant whole in the product design -- at least for us -- since we need to document the very critical aspect of our API: what data we return.Peter T. Brown supported this idea ·