Update api documentation

**Problem**
When working with lib, the error messages could be more descriptive.

**Suggestion**
Improve error handling and add detailed error messages.

**Context**
This would help with debugging and maintenance.

Start by locating the API documentation and the relevant code under lib, then identify which error paths the issue refers to. The issue is complete when error messages are more descriptive and the API documentation reflects the resulting behavior.

Written by the indexing model from the issue text.