How does GraphQL versioning work? Why is there no 'v1/v2'?
Updated Apr 28, 2026
Short answer
GraphQL strongly discourages API versioning, advocating instead for continuous schema evolution.
Deep explanation
In REST, breaking changes necessitate a /v2 endpoint. In GraphQL, you simply add new fields and types, and use the @deprecated directive to mark old fields as obsolete. Because clients request exact fields, adding new fields never breaks existing clients. Tools track field usage to safely remove deprecated fields once usage hits zero.
Unlock with a Pro subscription to view this section.
View pricingReal-world example
No real-world example available yet.
Unlock with a Pro subscription to view this section.
Upgrade to ProCommon mistakes
No common mistakes listed yet.
Unlock with a Pro subscription to view this section.
Upgrade to ProFollow-up questions
No follow-up questions available yet.
Unlock with a Pro subscription to view this section.
Upgrade to Pro