An API error is a chance to guide the user

Most APIs return generic error codes that leave developers guessing what went wrong. A “500 Internal Server Error” tells the user nothing and stops their work immediately. Poor error handling is the fastest way to increase support costs.

I have spent years interviewing users about their biggest frustrations. I’d focus on creating verbose, actionable error messages that tell the developer exactly how to fix the problem.