[api] implement recombine option

@indexzero make sure I'm sane here but this should work.