Designing APIs for AI Agents: Idempotency, Machine-Readable Errors, and 202 + Webhooks

Most APIs were designed for two consumers: a human reading documentation and code a human wrote once. An AI agent is neither. It discovers endpoints at runtime from a machine-readable description, fil