tyx
tyx5mo ago

How stable is the V2 API

Is the V1 API deprecated? I am just getting started w zitadel and I see some posts about the v1 and v2, also features flags related to that. Since I am just starting out I rather not deal with any unstable behaviour, is it fine to go along with the v1 for now as it's probably more mature? (I see a lot of v2 issues in this discord thread, so somewhat confused)
11 Replies
lev
lev5mo ago
I second this question.
FFO
FFO5mo ago
Hey, we are in the process of moving v1 to v2, generally speaking many features are under v2 available and stable, but some are not stable yet. If you start a project I would recommend you look into v2 since v1 will at one point go away (which is certainly a while out)
Gigi the Giraffe (Zitadel)
🎉 Looks like you just helped out another community member! Thanks for being so helpful <@191597217109245953>! You're now one step closer to leveling up—keep up the amazing peer support! 🚀
Arwin
Arwin2mo ago
Hey, jumping on this question. How stable is the v2 API currently? We see some discrepancies in the docs between when to use v1 or v2. Ideally we want to use v2 but currently we don't seem to be able to 100% do so.
Rajat
Rajat2mo ago
hey @Arwin thanks for your question and welcome to the server 🙂 you can read about the all the versions on our roadmap altho some features still require v1, the v2 API is stable for most features. So If starting a new project, consider v2 since v1 will eventually be deprecated .
Arnau
Arnau2mo ago
We are also looking forward to use v2 with the Java SDK. However most of V2 gRPC service methods are named Beta. As we are in production, switching to use something "Beta" also rings a bell to us in this upgrade/migration path.
Arwin
Arwin2mo ago
Thanks for the response @Rajat . I've checked out the roadmap but i can't seem to find a expected timeline for v1 deprecation. Like @Arnau we also noticed the BETA naming in a lot of endpoints and some v2 endpoints working but some not working. A definite release of v2 would help us a lot 🙂
Rajat
Rajat2mo ago
hey @Arwin thanks for the suggestion, I will see what I can do about it with the team.
Arwin
Arwin2mo ago
Thanks @Rajat! I'd love to hear updates on this when you have them, thanks for now!
Joebeurg
Joebeurg2mo ago
Following for updates as well Will the information include all SDKs or just the GRPC and REST APIs?
elina_shoko
elina_shoko2mo ago
Hey guys, Elina here from the product team :zitadel: we'll be updating the roadmap and info re expected deprecations/beta/GA for the V5 release in the coming week or so. We'll cover SDKs, too. Apologies for the confusion - the switch from V1 to V2 hasn't been the easiest but right now we're on a good track. Thank you for your patience 🙏

Did you find this page helpful?