mid-way updates for public API