Making APIs ready for agents

Bill Doerrfeld | June 25, 2025

My latest for The New Stack explores how to position APIs for AI agents

How do you make an API ready for AI agents to use? I posed this question to a handful of API experts and put together a comprehensive guide for The New Stack — published today.


The key takeaway: making RESTful APIs agent-ready takes way more than just wrapping them in MCP (although that's helpful). 


It'll require having a well-defined spec, setting new traffic controls, comprehensive error responses with next steps, documenting common workflows, and having monetization in place (when applicable), and more...


There are also some big security and ethical concerns to keep in mind.


This space is rapidly evolving, and the practices will likely change. But I think following this guide will be a really strong foundation for API providers in mid-2025.


Please give it a read and feel free to let me know what you think, especially if we missed any key areas.



Read: How To Prepare Your API for AI Agents
A

Multi-agent AI workflows reshape the developer's day-to-day

By Bill Doerrfeld • August 11, 2025
In a multi-agent coding workflow, an engineer leads a "team" of specialist AI agents to perform various SDLC tasks: scaffolding, coding, testing, log analysis, deployment, and more.
Open source software churn end of life

When critical open source goes end of life...

By Bill Doerrfeld • August 8, 2025
Open-source software churn is accelerating. With more frequent version end-of-lives and even total project abandonments, it's harder than ever to keep up.
Hype drives most programming language igrationsigra

Most language migrations are driven by hype

By Bill Doerrfeld • July 30, 2025
I covered a report from HostingAdvice.com, which found that the majority of programming language migrations are driven by hype, instead of proven outcomes.
Cross-functional teams help Stack Overflow adapt LeadDev DirectorPlus 2025

Can Stack Overflow keep pace with AI disruption?

By Bill Doerrfeld • July 28, 2025
Facing an existential crisis, Stack Overflow has had to pivot quickly. I synced with a director to discover what team strategies are helping them adapt.
System Initiative feature InfoWorld doerrfeld

System Initiative: a radical overhaul of infrastructure automation

By Bill Doerrfeld • July 14, 2025
System Initiative aims to replace the toil of maintaining config files with a data-based digital twin and visual modeling engine. An engine for DevOps, if you will.
CIOs describe why AI agents need APIs

Without APIs, agentic AI is all talk

By Bill Doerrfeld • July 10, 2025
My latest feature on CIO.com explores why CIOs view APIs as a critical linchpin to realize success with agentic AI. Learn what it'll all take.
AI tooling directorplus doerrfeld one year

Celebrating a year of DirectorPlus

By Bill Doerrfeld • June 30, 2025
A year into the DirectorPlus newsletter, I check back in with past guests on how their organizations are approaching AI tooling strategies.
Senior developers embarrassed tech stack leaddev doerrfeld storyblok report

Most senior developers are embarrassed by their tech stack

By Bill Doerrfeld • June 17, 2025
86% of developers are embarrassed by their tech stack. And, it's causing them to quit. I look at the implications of a report from Storyblok.
Comparing 6 multicloud management platforms Doerrfeld InfoWorld

Comparing 6 multicloud management platforms

By Bill Doerrfeld • June 16, 2025
The majority of enterprises are now multicloud. I compared six of the leading multicloud management solutions for InfoWorld.
Large action models LAMs story Bill Doerrfeld The New Stack

Move over LLMs — it's time for LAMs

By Bill Doerrfeld • June 10, 2025
AI researchers are calling the next class of models large action models (LAMs). For The New Stack, I explored what LAMs are, what examples are emerging in the market, and what experts think.