api: added more examples