updated API docs and API