docs update for API