Docs

Get one revision of an identity provider connection

GET
/idps/revisions/{revision_id}

Reads one revision of a connection by its revision_id, the value an auth attempt or a release pins.

The lookup is scoped to the project in project_id.

Authorization

headerAuthorizationBearer <token>

Scope: idp.read

Path Parameters

revision_id*string

The revision id, allocated when the revision was written.

Query Parameters

project_id*string

The unique identifier of the project

Match^[a-zA-Z0-9_-]+$

Response Body

The revision was retrieved successfully.

application/json
  1. response

An identity provider connection.

id*string

A unique connection id, generated when the connection is created, and shared by every revision. This id is referenced by the identity links.

revision_id*string

The id of the revision this row holds, pinned by auth attempts and releases. GET /idps/{id} and the query return the newest one; GET /idps/revisions/{revision_id} returns the requested revision.

slug*string

The identifier by which user schemas and flow definitions reference the connection. Fixed for the life of the connection.

created_at*string

When the connection was created.

Formatdate-time
updated_at*string

When this revision was created. On the newest revision, that is when the connection was last revised.

Formatdate-time
definition*

The stored connection document.

Example Request
import { configureZitadel, getApi } from "@zitadel/api/config";// In the browser, through the SDK proxy: the session cookie authenticates the call.const client = getApi(configureZitadel({ projectId: "proj_01KWH1P4MYS7F0N9WD3P2E4YM5" }));const idpRevision = await client.getIdpRevisionById(  "idprev_01KWH3B72K7M7F0N9WD3P2E4YN",  { project_id: "proj_01KWH1P4MYS7F0N9WD3P2E4YM5" },);
Example Response
{  "id": "idp_01KWH3B72K7M7F0N9WD3P2E4YM",  "revision_id": "idprev_01KWH3B72K7M7F0N9WD3P2E4YN",  "slug": "google",  "created_at": "2026-07-14T09:11:00Z",  "updated_at": "2026-07-14T09:11:00Z",  "definition": {    "slug": "google",    "protocol": "oidc",    "template": "google",    "display_name": "Google",    "subject_claim": "sub",    "claim_mapping": {      "email": "email",      "givenName": "given_name",      "familyName": "family_name"    },    "verified_claims": {      "email": "email_verified"    },    "provisioning": {      "creation": "auto"    },    "oidc": {      "issuer": "https://accounts.google.com",      "id_token_mapping": false,      "client_id": "${{ GOOGLE_CLIENT_ID }}",      "client_secret": "${{ GOOGLE_CLIENT_SECRET }}",      "token_endpoint_auth_method": "client_secret_basic",      "scopes": [        "openid",        "profile",        "email"      ],      "pkce_enabled": true,      "static_authorize_parameters": {        "prompt": "select_account"      }    }  }}

Was this helpful?