(doc) Add documentation for environments api call

The environments resource was updated but documentation was not changed
to reflect the changes.

This commit adds the documentation to describe new functionality.
Merge pull request #2994 from demophoon/maint/master/fix-http-environment-doc

(doc) Add documentation for environments api call