Making Your APIs AI-Ready
Masterclass at apiDays Paris — Dec 9, 13h30–17h30, CNIT La Défense
As AI agents, LLMs, and orchestration engines begin to consume our APIs directly, the rules of design are changing. Traditional REST or RPC patterns assume a human in the loop. One that is reading docs, interpreting meaning, and improvising around inconsistencies. Machines can’t do that
.
In my upcoming apiMasters masterclass, Making Your APIs AI-Ready, we’ll explore how to design APIs that are not just human-friendly but machine-savvy. APIs that are discoverable, self-describing, and ready for autonomous consumption.
We’ll trace five key shifts in modern API thinking, drawing on conceptual anchors from Donald Norman, Douglas Engelbart, Roy Fielding, Ted Nelson, and Christopher Alexander. Each showing how systems evolve when they learn to communicate not only messages but the meaning behind them.
You’ll learn how to:
Model API affordances with ALPS, TypeSpec, and Smithy
Embed metadata and context for AI-driven discovery
Standardize interactions across ecosystems
Build MCP-compatible wrappers for existing APIs
Evaluate and evolve your APIs based on telemetry and machine feedback
By the end of this half-day session, you’ll know how to make your APIs legible to the next generation of intelligent agents and how to future-proof your design practice for a world where systems talk to systems.
When: December 9th, 13h30–17h30
Where: CNIT – Paris La Défense
Register: Making Your APIs AI-Ready