TLDR Tech
Your API Docs Are Broken for AI Agents
AI coding agents are already hitting your developer documentation, and most of it is failing them silently. The agent fetches your page, strips the HTML, counts the tokens, decides the context window cost is too high, and discards it. No error. No warning. The agent just hallucinates a solution instead, or gives up.
For consumer finance technology teams, this matters right now. If you run a lending API, an open banking integration layer, or any developer-facing product, the people building against your platform are increasingly using agentic coding tools. Claude Code, Cursor, GitHub Copilot in agent mode. They are not reading your docs. Their AI is trying to.
The specific problem worth fixing
The failure modes are not exotic. They come down to a few concrete things:
- Token-bloated pages where the actual API reference is buried under marketing copy and navigation chrome
- robots.txt files that block crawlers indiscriminately, including the agents your partners are using to build integrations
- Capability signalling that was designed for humans skimming headers, not machines trying to infer what an endpoint actually does
Financial services documentation tends to be particularly bad here. Compliance requirements push teams toward verbose, heavily caveated prose. Legal reviews add disclaimers that obscure the technical signal. The result is documentation that reads fine to a human but looks like noise to an agent trying to extract a data model.
The deeper question is whether your integration experience is going to degrade quietly as agentic development becomes the default. The teams who will notice first are not yours. They are the fintechs and brokers building on top of your infrastructure, suddenly finding that their AI tools produce worse results against your API than against a competitor's. That is a distribution problem, not just a developer experience problem.
- agentic
- AI agents
- AI