⚠️
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