docs: add docs for the new api.

The status code received in this case is actually 400.