Lifetime issues.

It still returns an array, but only one or zero can be returned.

Apparently it does only have one 'l'.

User query APIs differ based on whether the requesting user is an
administrator or not. Allow code to select which one is wanted.

Got bored typing up docs part of the way through. Some of the more
obscure entities are left untouched.

Objects meant to be passed to POST or PUT endpoints are not represented
here (though they should be added).

Fixes #1.

Also add a workaround which has a much smaller edge case.