updated api examples