About the talk 

Your API documentation isn’t just for devs anymore — it’s for bots, copilots, and generative AI tools trying to make sense of your endpoints at scale. What happens when your API documentation confuses, misleads, or outright gaslights the very AI tools your developers are relying on? Short answer: nothing good. In this fast-paced session, Michaela Halliwell walks you through the worst practices in API documentation — the stuff that makes LLMs (and the humans using them) spiral into chaos. From cryptic payloads to auto-generated gibberish, you’ll see why today’s dev portals need more than just a Swagger file to be AI-ready.Michaela Halliwell walks through the real-world checklist you’ll need to make your dev portal AI-friendly. She’ll share lessons learned from launching AI-enhanced tooling like Copilot, explain where LLMs struggle with traditional docs, and help you future-proof your portal for both human and machine consumers.

About the speaker 

Michaela Halliwell is an experienced Product Manager with over ten years in the tech industry. Her background includes leading API and data platform strategies across various sectors, including cybersecurity, telematics, FinTech, heavy civil construction, and energy technology. Currently at HCSS, Michaela is focused on unifying platform efforts and managing API, AI, and data products. Her work helps enterprise clients transform complex data into actionable insights. She is particularly passionate about creating excellent developer experiences, integrating AI into reporting and developer tools, and fostering ecosystems that benefit both internal teams and external partners.