added information to the API documentation