add description of API enpoint
Merge branch 'master' of github.com:cloudfoundry/docs-dev-guide