Difficult to work out reason for Http 422 error in api

That is great, thankyou.
But wish I had known about this before, is it documented at https://docs.discourse.org/ I can’t see it ?