Range '4XX' used in the response instead of the explicit error code

Issue ID: v3-warning-specific-error-code

Description

Your API uses the value 4XX for a range of error codes instead of an explicit error code. While the OpenAPI Specification (OAS) allows this, it might not be what you want.

Specifying a range instead of a specific code seems like a quick way of defining your responses and sometimes it may well be the right choice. However, using explicit error codes (such as 400, 401, 403, 404, or 429) provides more granular understanding what kind of errors are occurring and allows using the information, for example, for monitoring and alerts or in downstream services. It also lets your API consumers better understand what the problem is and how it might be solved.

For more details, see RFC 9110.