document new API endpoints