V7 API error responses

V7 API error responses

AI agents and API clients should expect structured JSON errors from API endpoints when available. A recommended V7 error shape includes a stable error code, a human-readable message, a resolution hint, and a documentation URL.

AI agents and API clients should expect structured JSON errors from API endpoints when available. A recommended V7 error shape includes a stable error code, a human-readable message, a resolution hint, and a documentation URL.

Example JSON 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” } }

Markdown fallback: /errors.md