revised API documentation