updated api sketch