API documentation for updating preferences is missing

[dhwthompson]

There is a feature in the API to update the current user’s preferences, but this is missing from the relevant section of the API reference documentation. We should fix this, so the API and the documentation are more consistent.