📝
AB-146
Operation descriptions
What it means
Every OpenAPI operation has a description or summary.
Why it matters
Agents need text descriptions to understand what each endpoint does — without them, operations are opaque.
✗
What's wrong
paths: { /charges: { get: {} } }
✓
What's right
paths: { /charges: { get: { description: 'List all charges with pagination' } } }
Check this rule on your site
Enter your URL to check just this one rule (AB-001).