updated API examples