- likes
- 22
- comments
- 4
Post
API design has always had one reader in mind: a human developer with docs open in one tab and Stack Overflow in the other. Now there's a second reader that reads differently. Agents don't file support tickets, and they can't squint at "400: invalid request." Every doc detour is billed in turns and tokens. Every verbose response displaces the reasoning they need to finish the job. With this in mind, we wrote down the tenets we're now holding our own API to: 1. Errors are guidance 2. Budget the reader's context 3. Self-description beats documentation 4. Safe at machine tempo 5. Access without a human in the loop 6. The agent surface is a product, not a mirror Every one of these would be familiar to an API designer from a decade ago: actionable errors, idempotency, least privilege. But human developers have been grace-filled and forgiving of API designs that don't follow these tenets. Good API design is really a net benefit for your customers' agents that makes them more cost efficient and less churn-inducing and ultimately lets them get the job done right. Full post: https://lnkd.in/d4g7CRW8