# V7 API errors Use /errors for the human-readable API error page. Agents should prefer structured JSON error responses where available. ## Recommended shape { error: { code: “unauthorized”, message: “Authentication is required.”, hint: “Send a valid bearer token and review /auth.md.”, documentation_url: “https://v7labs.com/auth.md” } } ## Agent handling Parse the stable code first. Show the message to the user. Use hint and documentation_url to propose the next action. Do not retry indefinitely. For authorization failures, inspect WWW-Authenticate and /.well-known/oauth-protected-resource when present. ## Related resources Auth guide: /auth.md API overview: /api Sandbox: /test-mode.md