next_call pattern in API responses

⚡ Actionability Pillar: Understandability Moderate effort Severity: low Est. cost: $0 Gap: semantic Fix: assisted

What it means

Your OpenAPI spec includes a next_call field in response schemas with method, path, and why to guide agents to the next request.

Why it matters

AI agents can follow a chain of API calls autonomously without hardcoding navigation logic, improving actionability and reducing integration friction.

✗

What's wrong

{"data": {"id": 123}}

✓

What's right

{"data": {"id": 123}, "next_call": {"method": "GET", "path": "/api/v1/items/123", "why": "Fetch item details"}}

Check this rule on your site

Enter your URL to check just this one rule (AB-001).

Related rules in Actionability

🔄 Guide and API Consistency

🔑 Authentication Declared

🧩 Capability Coverage

🤝 A2A Agent Card Published

✅ A2A Agent Card Verified

← Back to all rules

Machine-Readable

This rule is also available as JSON: /rules/AB-166.json

Explore More

All Rules
Browse the complete rules catalog
Agent Guide
Learn how to fix this rule
Blog
Related articles on agent readiness