update environment api docs

Signed-off-by: Adam Stokes <adam.stokes@ubuntu.com>