added examples and current API options