Getting the Right API Faster
summary
Claims that combining example mapping (20–25 minute three‑amigos sessions) with OpenAPI + Arzo and LLM prompting produces valid specs and runnable workflows far faster than hand design. Process: capture colored cards → human converts examples into prompts → LLM generates OpenAPI → validate with Spectral linting → generate Arzo workflow → auto‑produce docs, SDK snippets (C, TypeScript) and a published adopt‑pet workflow. Demo output validates with no errors, a few warnings, and yields a usable developer product.
AI-written summary · about
chapters (14)
- 0:00API development challenges
- 1:08Developer and agent experience
- 3:13API documentation role
- 5:01API validation and governance
- 7:49Modern API delivery
- 9:36Example mapping for API discovery
- 13:26Example mapping session
- 16:59AI-assisted API specification
- 18:23OpenAPI generation demo
- 20:10Agent-ready workflows with Arzo
- 21:56Developer portal docs
- 22:59Human-AI collaboration
- 23:20Customer-centric API design
- 24:03Closing and resources
related talks
22mThe Arazzo Specification: A Tapestry for API Workflows.
19mAutomate your API to perfection
28mThe Arazzo Specification
49mBuilding Software Better: API Lifecycle Management for Developers
38mZen And The Art Of Automanually Creating API Documentation - An Inquiry Into Process
30mLeveraging Prompt Engineering for Effective OpenAPI Descriptions of APIs
40mThe Four Stages of OpenAPI
35mOpensource API Tools to agile your apifirst strategy.