[api] update docs to include feature from PR #50