Add documentation for listing API

Add parameter to define for the sorting criteria of the returned blobs. @xla 
If no `limi` parameter is provided by the caller, this will be `-1` and return an error. Unless I'm missing something this sounds like `limit` is required, which would break the assumption that you can call the endpoint without any params and get a default response.