About the talk

"Documentation is shifting left—but not in the way we expected. In 2025, specs are the documentation. As AI agents begin to interpret and act on APIs autonomously, the OpenAPI spec is no longer a backend formality—it’s the first point of contact, the contract, and increasingly, the interface.

In this talk, I’ll share what it means to treat OpenAPI like user-facing documentation—from syntax choices to semantic intent—and how doing so unlocks new affordances for agentic AI.

Drawing on real examples from platform ecosystems and AI-integrated workflows, we’ll cover:

1. Making specs semantically expressive: How descriptions, examples, and constraints can serve both LLMs and humans in context.
2. Surfacing specs through AI interfaces: What happens when your chatbot, not your homepage, is your primary API portal.
3. Legacy uplift: Turning brittle specs into structured affordances for discoverability, chaining, and error recovery.
4. Specs as conversation starters: Why your future documentation workflow starts in Stoplight and ends in prompt design.

Expect takeaways on how to treat OpenAPI not just as a dev tool, but as a durable artifact of interaction design for humans and machines alike. If docs are becoming data, specs are where the story starts."

About the speaker

Aman is a Content Design Manager at Autodesk India, where he enjoys exploring how AI and large language models can make technical content smarter and more useful. He's big on structured content and enjoys helping writers and teams build better systems for docs that scale. 

When he's not deep in content strategy or testing out new ideas, you'll probably find him walking through Hyderabad's green corridors, diving into a sci-fi book, indulging in a family board game, or trying out a new vegetarian recipe.