⚠️
AB-012
Structured Error Responses
🤖 Machine-Readable
Pillar: Discovery
Moderate effort
Severity: low
Est. cost: $10-50
Gap: documentation
Fix: deterministic
What it means
Your API returns errors in a consistent, machine-readable format.
Why it matters
When agents get a structured error, they can understand what went wrong and retry correctly. Plain text errors are useless.
Evidence expected
This rule is verified by:
openapi json_schema Source: OpenAPI / JSON Schema
✗
What's wrong
Errors return plain text like 'Something went wrong'. Agents can't parse or respond to this.
✓
What's right
Errors return structured data with error code, message, and suggested action.
Check this rule on your site
Enter your URL to check just this one rule (AB-001).
Related rules in Machine-Readable
Machine-Readable
This rule is also available as JSON: /rules/AB-012.json
Explore More
-
All Rules
Browse the complete rules catalog
-
Agent Guide
Learn how to fix this rule
-
Blog
Related articles on agent readiness