document the new meta api