[api] add an old-mode flag for explicit backwards compat