What is a common mistake with OpenAPI and API documentation in Web API?

Treating generated documentation as correct without maintaining examples, error responses, and security definitions creates misleading contracts. In practice, the value of this concept comes from understanding where it belongs in the architecture, what problem it solves, and what constraints or tradeoffs it introduces.