Change8
Error1 reports

Fix AsyncValidationError

in Instructor

Solution

AsyncValidationError in instructor often arises from asynchronous validators (like those used with `before`/`after` hooks or `validator` decorators) failing during data parsing or model creation. Ensure your asynchronous validators correctly handle exceptions and re-raise `ValidationError` (or a subclass) with appropriate error details to signal validation failure; also, verify that the `parse:error` hook is correctly implemented to catch and handle these asynchronous validation errors in JSON mode.

Related Issues

Real GitHub issues where developers encountered this error:

Timeline

First reported:Sep 25, 2025
Last reported:Sep 25, 2025

Need More Help?

View the full changelog and migration guides for Instructor

View Instructor Changelog