(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.
Typo: all the "etc"s ended up as "ect" instead!