It is unfortunate the javadocs here don't exist. It is supposed to return a list of things which can be used in a `postAll` thing, such that they have some kind of parity between what you `get` and what you `post`.