Document error codes in API spec

[yamcodes]

Clear and concise description of the problem

The possible error responses from each endpoint are not documented within the OpenAPI spec.

Suggested solution

Document all the possible error responses from each endpoint.

Alternative

No response

Additional context

No response

Validations

• [x] Read the Contributing Guide.
• [x] Read the README.md.
• [x] Check that there isn't already an issue that requests the same feature.