WIP groups: API addition

use `:returns:`