add documentation of API options