api: final edits before review