(PUP-1151) Document environments responses

This provides the first pass at defining the responses from the new V2
environment endpoint. It also specifies that the responses will be in JSON and
adds JSON as a dependency to puppet.