need to document different values of queuePosition

and make sure the API returns them if relevant