[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"glossary-api-versioning::en":3,"gloss-cluster-api-versioning::en":26,"gloss-next-api-versioning::en":9},{"slug":4,"category":5,"name":6,"definition":7,"meta_desc":8,"faq":9,"schema_markup":9,"related":10},"api-versioning","dev-tools","API Versioning","API versioning is the practice of managing changes to a public API so that existing clients keep working when you evolve it. Because other people's apps, mobile clients, and integrations depend on your response shapes, you can't just rename a field or drop an endpoint — that breaks them silently. Versioning gives you a way to ship breaking changes under a new version (v1, v2) while the old one keeps serving. Common strategies are URL-based (\u002Fv1\u002Forders), header-based (Accept: application\u002Fvnd.api+json;version=2), or query parameters. The broader discipline is distinguishing breaking changes (removing a field, changing a type) from backward-compatible ones (adding an optional field), and only bumping the version for the former. For AI\u002FSaaS builders shipping a public or partner API, versioning plus a clear deprecation policy is what lets you move fast internally without breaking every customer. Practical note: version from day one even if you only have v1, and communicate deprecation timelines long before you remove anything.","API versioning is how you evolve a public API without breaking the clients already calling it — URL paths, headers, or dated versions plus a deprecation policy.",null,[11,14,17,20,23],{"slug":12,"name":13},"api","API",{"slug":15,"name":16},"idempotency","Idempotency",{"slug":18,"name":19},"sdk","Software Development Kit (SDK)",{"slug":21,"name":22},"semantic-versioning","Semantic Versioning (SemVer)",{"slug":24,"name":25},"webhook","Webhook",[27,31,34,38,41,44,47,50,53,56,59,62],{"slug":28,"category":5,"name":29,"updated_at":30},"agent","Agent","2026-08-24T02:46:36+00:00",{"slug":32,"category":5,"name":33,"updated_at":30},"ai-code-assistant","AI Coding Assistant",{"slug":35,"category":5,"name":36,"updated_at":37},"api-gateway","API Gateway","2026-08-24T02:46:37+00:00",{"slug":39,"category":5,"name":40,"updated_at":30},"autonomous-agent","Autonomous Agent",{"slug":42,"category":5,"name":43,"updated_at":37},"blue-green-deployment","Blue-Green Deployment",{"slug":45,"category":5,"name":46,"updated_at":37},"canary-deployment","Canary Deployment",{"slug":48,"category":5,"name":49,"updated_at":37},"chaos-engineering","Chaos Engineering",{"slug":51,"category":5,"name":52,"updated_at":30},"ci-cd","Continuous Integration \u002F Continuous Deployment (CI\u002FCD)",{"slug":54,"category":5,"name":55,"updated_at":37},"circuit-breaker","Circuit Breaker",{"slug":57,"category":5,"name":58,"updated_at":37},"cli","Command-Line Interface (CLI)",{"slug":60,"category":5,"name":61,"updated_at":37},"cloud-development-environment","Cloud Development Environment (CDE)",{"slug":63,"category":5,"name":64,"updated_at":30},"code-completion","Code Completion"]