Designing APIs for AI Agents: Idempotency, Machine-Readable Errors, and 202 + Webhooks
Human callers read prose and ask a teammate when confused; agents retry, chain calls, and act on whatever a response most resembles. A few design rules separate APIs agents use reliably from ones they misuse: idempotency, strict schemas, machine errors, and async jobs.