[API Version] Not All Endpoint from V1 exists in V2

Anggakara · 2025-10-21T15:07:33.369Z

i notice there are several endpoint that still not exist yet in the v2 like this https://zitadel.com/docs/apis/resources/admin/admin-service-list-providers the v2 only support the active one, not all idps list may I know the mapping documentation from v1 to v2? or maybe you can explain me further i plan to migrate all the endpoint in v1 to v2, but facing this issue. please kindly help

A

Ask Inkeep•10/21/25, 3:07 PM

Hi @Anggakara, I'm an AI assistant for ZITADEL. While a team member reviews this question, I'll see if I can find relevant sources for your question.

A

AnggakaraOP•10/21/25, 3:08 PM

cc @Matías @Rajat

A

Ask Inkeep•10/21/25, 3:10 PM

Hmm.. Seems there was an issue processing this question. Please try again or tag a team member.

R

Rajat•10/21/25, 3:17 PM

hey @Anggakara I will take a look at it, thnaks for the ping.

R

Rajat•10/21/25, 3:18 PM

hey @Anggakara you are looking for this
https://zitadel.com/docs/product/roadmap#v4x
that gives you all the exact info of which v1 endpoints are deprecated

R

Rajat•10/21/25, 3:18 PM

please let me know if this helps

A

AnggakaraOP•10/21/25, 3:19 PM

so it's expected that several endpoint from v1 not exist in v2 like this case?
this endpoint https://zitadel.com/docs/apis/resources/admin/admin-service-list-providers deprecated, because not exist in v2? cmiiw ya @Rajat

ZITADEL Docs

Returns a list of identity providers (social/enterprise login) configured on an instance level. e.g Google, AzureAD, etc.

R

Rajat•10/21/25, 3:51 PM

this one is till not deprecated, very specific but you can continue using this, for now.

A

AnggakaraOP•10/21/25, 3:52 PM

may i also ask, didi you already plan for zitadel v4 to be deprecated on 2026 Q1?

A

AnggakaraOP•10/21/25, 3:52 PM

then which endpoint you encourage to move? only for login v1 to v2?
i am afraid it will deprecated soon for that kind of spesific endpoints

A

AnggakaraOP•10/21/25, 3:52 PM

cc @Rajat

AAnggakara then which endpoint you encourage to move? only for login v1 to v2? i am afraid ...

R

Rajat•10/21/25, 3:58 PM

you can confidently use V2 endpoints MOST of the places. And V1 for specific functioanlity like you mentioned.
You can refer to our Zitadel Postman collection for all the official apis that we use atm. This also makes it easy for you to just simple use all the endpoints without trying to curate it on your own.

A

AnggakaraOP•10/22/25, 9:07 AM

i see thanks a lot @Rajat , means a lot to me. i can simply ignore the Deprecated endpoint via its prefix name.
may I also know for the grpc request sample? i've try to use the insomnia and import the proto file but have an error. i've tried using admin.proto and management.proto have the same error

The file C:\Users\{{SOMENAME}}\Documents\admin.proto could not be parsed
Stack trace
Error: illegal value '{' (C:/Users/{{SOMENAME}}/Documents/admin.proto, line 48)
    at G (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:1902)
    at L (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:2291)
    at ye (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:7402)
    at xe (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:7073)
    at _ (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:8918)
    at j (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:12:29947)
    at https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:12:30522
    at https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:12:401
    at FSReqCallback.readFileAfterClose [as oncomplete] (node:internal/fs/read/context:68:3)

The file C:\Users\{{SOMENAME}}\Documents\admin.proto could not be parsed
Stack trace
Error: illegal value '{' (C:/Users/{{SOMENAME}}/Documents/admin.proto, line 48)
    at G (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:1902)
    at L (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:2291)
    at ye (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:7402)
    at xe (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:7073)
    at _ (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:8918)
    at j (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:12:29947)
    at https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:12:30522
    at https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:12:401
    at FSReqCallback.readFileAfterClose [as oncomplete] (node:internal/fs/read/context:68:3)

The file C:\Users\{{SOMENAME}}\Documents\admin.proto could not be parsed
Stack trace
Error: illegal value '{' (C:/Users/{{SOMENAME}}/Documents/admin.proto, line 48)
    at G (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:1902)
    at L (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:2291)
    at ye (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:7402)
    at xe (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:7073)
    at _ (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:8918)
    at j (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:12:29947)
    at https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:12:30522
    at https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:12:401
    at FSReqCallback.readFileAfterClose [as oncomplete] (node:internal/fs/read/context:68:3)

The file C:\Users\{{SOMENAME}}\Documents\admin.proto could not be parsed
Stack trace
Error: illegal value '{' (C:/Users/{{SOMENAME}}/Documents/admin.proto, line 48)
    at G (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:1902)
    at L (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:2291)
    at ye (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:7402)
    at xe (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:7073)
    at _ (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:19:8918)
    at j (https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:12:29947)
    at https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:12:30522
    at https://insomnia-app.local/assets/organization._organizationId.project._projectId.workspace._workspaceId.debug-BPRJShku.js:12:401
    at FSReqCallback.readFileAfterClose [as oncomplete] (node:internal/fs/read/context:68:3)

AAnggakara i see thanks a lot @Rajat , means a lot to me. i can simply ignore the Deprecate...

R

Rajat•10/22/25, 12:38 PM

hey @Anggakara I have not used insomnia so I cant really tell what works and what doesnt, we recommend using postman.

F

fcoppede•10/22/25, 2:04 PM

hello @Anggakara, can you try using the proto and/or openapi files inside the docs/.artifacts folder?

A

AnggakaraOP•10/23/25, 1:36 AM

the same for postman @Rajat