move allocateIds to request & generate docs.

:warning: