Skip to main content

FeatureUrls

The URLs for various features.

type FeatureUrls {
  apiUrlLegacy: URL!
  apiUrlServiceFirst: URL!
  conciergeUrl: URL
  docsUrl: URL!
  effectiveApiUrl: URL!
  effectiveConciergeUrl: URL!
  effectiveOidcAuthorityUrl: URL
  oidcAuthorityUrl: URL @deprecated
  oidcAuthorityUrlLegacy: URL
  oidcAuthorityUrlServiceFirst: URL
  portalUrl: URL!
}

Fields​

FeatureUrls.apiUrlLegacy ● URL! non-null scalar​

The API base URL advertised when service-first addressing is OFF (legacy state) — the <instance>.api host. NOT toggle-aware; provided so admin tooling can show the configuration impact of toggling, the same way oidcAuthorityUrlLegacy does. Use effectiveApiUrl for "the host to call right now".

FeatureUrls.apiUrlServiceFirst ● URL! non-null scalar​

The API base URL advertised when service-first addressing is ON — the api.<root> host. NOT toggle-aware; the counterpart to apiUrlLegacy. Collapses onto apiUrlLegacy in localdev, where there is no instance root and both variants resolve to the same host.

FeatureUrls.conciergeUrl ● URL scalar​

Service-first Concierge URL (concierge.<root>), when the instance has a service-first root. The holder-facing passkey surface must run here once service-first addressing is active.

FeatureUrls.docsUrl ● URL! non-null scalar​

URL of the documentation website

FeatureUrls.effectiveApiUrl ● URL! non-null scalar​

The API base URL clients should use RIGHT NOW for GraphQL and interactive Entra sign-in: the legacy <instance>.api host before the service-first migration, api.<root> after it. Toggle-aware single source of truth, so a client can follow the migration at runtime instead of baking a host in at build time. The OIDC issuer lives on this same host, so it is never the dormant idp.<root> host.

FeatureUrls.effectiveConciergeUrl ● URL! non-null scalar​

The user-facing Concierge base URL clients should use RIGHT NOW for holder-facing links (sign-in, demo, issuance, presentation): the service-first host (concierge.<root>) when service-first addressing is active and available, otherwise the legacy portal host. Toggle-aware single source of truth so Composer/Concierge links and server-generated URLs all agree.

FeatureUrls.effectiveOidcAuthorityUrl ● URL scalar​

The OIDC issuer/authority clients should use RIGHT NOW — the toggle-resolved authority for the instance's current service-first addressing state. Null when OIDC is disabled.

NAMING: every toggle-resolved URL on this type is prefixed effective (see effectiveApiUrl, effectiveConciergeUrl). Internally an unqualified name means the LEGACY variant, which silently ignores the toggle, so the unqualified oidcAuthorityUrl above is deprecated rather than load-bearing — but it is NOT to be removed without a customer migration, as it is part of the public REST/GraphQL surface.

FeatureUrls.oidcAuthorityUrl ● URL deprecated scalar​

DEPRECATED

Use effectiveOidcAuthorityUrl instead — identical value, named consistently with effectiveApiUrl and effectiveConciergeUrl

URL of the OIDC authority (when enabled) — the issuer/authority for the instance's CURRENT service-first addressing state. Equals oidcAuthorityUrlLegacy or oidcAuthorityUrlServiceFirst depending on the enableServiceFirstAddressing setting.

Retained as a customer-facing alias of effectiveOidcAuthorityUrl. Always identical to it — see the discovery resolver test that pins the two together — so existing integrations keep working unchanged.

FeatureUrls.oidcAuthorityUrlLegacy ● URL scalar​

The OIDC issuer/authority advertised when service-first addressing is OFF (legacy state) — the value OIDC clients must be configured with as their issuer/authority while the instance is in that state. Provided so admin tooling can show the configuration impact of toggling. Null when OIDC is disabled.

FeatureUrls.oidcAuthorityUrlServiceFirst ● URL scalar​

The OIDC issuer/authority advertised when service-first addressing is ON — the value OIDC clients must be configured with as their issuer/authority while the instance is in that state. Provided so admin tooling can show the configuration impact of toggling. Null when OIDC is disabled.

FeatureUrls.portalUrl ● URL! non-null scalar​

URL of the portal

Member Of​

Discovery object