Microsoft

Microsoft Graph: Identity, sign-in and policies

Configure conditional access and authentication policies, authentication method settings, identity providers, user flows and risk detection (Identity…

Identity & security#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Configure conditional access and authentication policies, authentication method settings, identity providers, user flows and risk detection (Identity Protection).

This listing is one area of Microsoft Graph, the single REST API for Microsoft 365, Outlook, OneDrive, Teams and Microsoft Entra ID. It holds 400 of the area's requests, the most direct ones first, generated from Microsoft's own OpenAPI description of Graph v1.0. The other areas (mail, calendar, files, Teams, users and more) are listed separately on the Microsoft page.

Get an access token

  1. Sign in to the Microsoft Entra admin center and open App registrations > New registration. For a quick test, the Graph Explorer signs you in and shows a token without registering anything.
  2. Under API permissions, add the Microsoft Graph permissions this area needs, for example: Policy.Read.All, Policy.ReadWrite.ConditionalAccess, IdentityRiskEvent.Read.All. Delegated permissions act as the signed-in user; application permissions act as the app itself and need an administrator's consent.
  3. Under Certificates & secrets, create a client secret (keep it out of shared collections).
  4. Get a token from https://login.microsoftonline.com/ /oauth2/v2.0/token: the authorization-code flow for a user, or grant_type=client_credentials with scope=https://graph.microsoft.com/.default for an app. Send it as Authorization: Bearer .

Using these requests

  • Base URL: https://graph.microsoft.com/v1.0. /me/... paths act on the signed-in user; with an application token use /users/{id or userPrincipalName}/... instead.
  • Shape responses with OData query parameters: $select (fields), $filter, $orderby, $top, $expand and $search (some need the ConsistencyLevel: eventual header). Long lists are paged: follow @odata.nextLink.
  • Combine up to 20 requests in one call with POST /$batch.

Common errors

StatusCodeWhat to do
401InvalidAuthenticationTokenThe token is missing, expired or for another resource: get a new one for https://graph.microsoft.com.
403Authorization_RequestDenied / ErrorAccessDeniedAdd the permission listed in the request's docs and grant consent.
404ResourceNotFound / itemNotFoundCheck the id; ids from another user or tenant are not found.
429TooManyRequestsThrottled: wait the Retry-After seconds, then retry.

Docs: Identity, sign-in and policies overview · Permissions reference · Throttling

Endpoints 400

Identity

  • GETGet identity/identity
  • PATCHUpdate identity/identity

Policies

  • GETList policies/policies
  • PATCHUpdate policies/policies
  • GETGet ownerless group policy/policies/ownerlessGroupPolicyRead the properties of an ownerlessGroupPolicy object.
  • PATCHUpdate ownerless group policy/policies/ownerlessGroupPolicyCreate or update the ownerlessGroupPolicy for the tenant. If the policy doesn't exist, it creates a new one; if the policy exists, it updates the existing…
  • GETGet device registration policy/policies/deviceRegistrationPolicyRead the properties and relationships of a deviceRegistrationPolicy object. Represents deviceRegistrationPolicy quota restrictions, additional authentication,…

Identity providers

  • GETList identity providers/identityProvidersDeprecated. Retrieve all identityProviders in the directory.
  • POSTCreate identity provider/identityProvidersDeprecated. Create a new identityProvider by specifying display name, identityProvider type, client ID, and client secret.
  • GETAvailable provider types (identity provider)/identityProviders/availableProviderTypes()Deprecated. Retrieves all identity provider types available in a directory.
  • GETGet identity provider/identityProviders/:identityProvider-idDeprecated. Retrieve the properties of an existing identityProvider.
  • DELETEDelete identity provider/identityProviders/:identityProvider-idDeprecated. Delete an existing identityProvider.
  • PATCHUpdate identity provider/identityProviders/:identityProvider-idDeprecated. Update properties in an existing identityProvider.

Identity protection

  • GETGet identity protection/identityProtection
  • PATCHUpdate identity protection/identityProtection

Authentication methods policy

  • GETGet authentication methods policy/authenticationMethodsPolicy
  • PATCHUpdate authentication methods policy/authenticationMethodsPolicy

Certificate based auth configuration

  • GETGet certificate based auth configuration/certificateBasedAuthConfiguration
  • POSTCreate certificate based auth configuration/certificateBasedAuthConfiguration
  • GETGet certificate based auth configuration/certificateBasedAuthConfiguration/:certificateBasedAuthConfiguration-id
  • DELETEDelete certificate based auth configuration/certificateBasedAuthConfiguration/:certificateBasedAuthConfiguration-id
  • PATCHUpdate certificate based auth configuration/certificateBasedAuthConfiguration/:certificateBasedAuthConfiguration-id

Authentication method configurations

  • GETList authentication method configurations/authenticationMethodConfigurations
  • POSTCreate authentication method configuration/authenticationMethodConfigurations
  • GETGet authentication method configuration/authenticationMethodConfigurations/:authenticationMethodConfiguration-id
  • DELETEDelete authentication method configuration/authenticationMethodConfigurations/:authenticationMethodConfiguration-id
  • PATCHUpdate authentication method configuration/authenticationMethodConfigurations/:authenticationMethodConfiguration-id

Identity: verified id

  • GETGet verified id/identity/verifiedIdEntry point for verified ID operations.
  • DELETEDelete verified id/identity/verifiedId
  • PATCHUpdate verified id/identity/verifiedId
  • GETList profiles/identity/verifiedId/profilesGet a list of the verifiedIdProfile objects and their properties.
  • POSTCreate profile/identity/verifiedId/profilesCreate a new verifiedIdProfile object.
  • GETGet profile/identity/verifiedId/profiles/:verifiedIdProfile-idRead the properties and relationships of verifiedIdProfile object.
  • DELETEDelete profile/identity/verifiedId/profiles/:verifiedIdProfile-idDelete a verifiedIdProfile object.
  • PATCHUpdate profile/identity/verifiedId/profiles/:verifiedIdProfile-idUpdate the properties of a verifiedIdProfile object.

Identity: b2x user flows

  • GETList b2x user flows/identity/b2xUserFlowsRetrieve a list of b2xIdentityUserFlow objects.
  • POSTCreate b2x user flow/identity/b2xUserFlowsCreate a new b2xIdentityUserFlow object.
  • GETGet b2x user flow/identity/b2xUserFlows/:b2xIdentityUserFlow-idRetrieve the properties and relationships of a b2xIdentityUserFlow object.
  • DELETEDelete b2x user flow/identity/b2xUserFlows/:b2xIdentityUserFlow-idDelete a b2xIdentityUserFlow object.
  • PATCHUpdate b2x user flow/identity/b2xUserFlows/:b2xIdentityUserFlow-id
  • GETList languages/identity/b2xUserFlows/:b2xIdentityUserFlow-id/languagesRetrieve a list of languages supported for customization in a B2X user flow.
  • POSTCreate language/identity/b2xUserFlows/:b2xIdentityUserFlow-id/languages
  • GETList identity providers/identity/b2xUserFlows/:b2xIdentityUserFlow-id/identityProvidersDeprecated. Get the identity providers in a b2xIdentityUserFlow object.
  • GETList user attribute assignments/identity/b2xUserFlows/:b2xIdentityUserFlow-id/userAttributeAssignmentsGet the identityUserFlowAttributeAssignment resources from the userAttributeAssignments navigation property in a b2xIdentityUserFlow.
  • POSTCreate user attribute assignment/identity/b2xUserFlows/:b2xIdentityUserFlow-id/userAttributeAssignmentsCreate a new identityUserFlowAttributeAssignment object in a b2xIdentityUserFlow.
  • GETGet api connector configuration/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfigurationGet the apiConnectorConfiguration property in a b2xIdentityUserFlow to detail the API connectors enabled for the user flow.
  • GETList user flow identity providers/identity/b2xUserFlows/:b2xIdentityUserFlow-id/userFlowIdentityProviders
  • GETList b2x user flows references/identity/b2xUserFlows/:b2xIdentityUserFlow-id/userFlowIdentityProviders/$ref
  • POSTAdd b2x user flow reference/identity/b2xUserFlows/:b2xIdentityUserFlow-id/userFlowIdentityProviders/$ref
  • DELETERemove b2x user flow reference/identity/b2xUserFlows/:b2xIdentityUserFlow-id/userFlowIdentityProviders/$ref?@id=string
  • POSTSet order (user attribute assignment)/identity/b2xUserFlows/:b2xIdentityUserFlow-id/userAttributeAssignments/setOrderSet the order of identityUserFlowAttributeAssignments being collected within a user flow.
  • GETGet order (user attribute assignment)/identity/b2xUserFlows/:b2xIdentityUserFlow-id/userAttributeAssignments/getOrder()Get the order of identityUserFlowAttributeAssignments being collected within a user flow.
  • GETGet identity provider/identity/b2xUserFlows/:b2xIdentityUserFlow-id/identityProviders/:identityProvider-idDeprecated. The identity providers included in the user flow.
  • GETGet language/identity/b2xUserFlows/:b2xIdentityUserFlow-id/languages/:userFlowLanguageConfiguration-idRead the properties and relationships of a userFlowLanguageConfiguration object. These objects represent a language available in a user flow. Note: Language…
  • DELETEDelete language/identity/b2xUserFlows/:b2xIdentityUserFlow-id/languages/:userFlowLanguageConfiguration-id
  • PATCHUpdate language/identity/b2xUserFlows/:b2xIdentityUserFlow-id/languages/:userFlowLanguageConfiguration-id
  • GETGet post federation signup/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postFederationSignup
  • DELETEDelete post federation signup/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postFederationSignup
  • PATCHUpdate post federation signup/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postFederationSignup
  • GETGet post attribute collection/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postAttributeCollection
  • DELETEDelete post attribute collection/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postAttributeCollection
  • PATCHUpdate post attribute collection/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postAttributeCollection
  • GETGet user attribute assignment/identity/b2xUserFlows/:b2xIdentityUserFlow-id/userAttributeAssignments/:identityUserFlowAttributeAssignment-idRead the properties and relationships of an identityUserFlowAttributeAssignment object.
  • DELETEDelete user attribute assignment/identity/b2xUserFlows/:b2xIdentityUserFlow-id/userAttributeAssignments/:identityUserFlowAttributeAssignment-idDelete an identityUserFlowAttributeAssignment object.
  • PATCHUpdate user attribute assignment/identity/b2xUserFlows/:b2xIdentityUserFlow-id/userAttributeAssignments/:identityUserFlowAttributeAssignment-idUpdate the properties of a identityUserFlowAttributeAssignment object.
  • GETList api connector configuration references/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postFederationSignup/$ref
  • PUTSet api connector configuration/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postFederationSignup/$ref
  • DELETERemove api connector configuration reference/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postFederationSignup/$ref
  • GETList api connector configuration references/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postAttributeCollection/$ref
  • PUTSet api connector configuration/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postAttributeCollection/$ref
  • DELETERemove api connector configuration reference/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postAttributeCollection/$ref
  • DELETERemove b2x user flow reference/identity/b2xUserFlows/:b2xIdentityUserFlow-id/userFlowIdentityProviders/:identityProviderBase-id/$ref
  • GETList default pages/identity/b2xUserFlows/:b2xIdentityUserFlow-id/languages/:userFlowLanguageConfiguration-id/defaultPagesRead the values in a userFlowLanguagePage object for a language in a user flow. These values are shown to a user during a user journey defined by a user flow.
  • POSTCreate default page/identity/b2xUserFlows/:b2xIdentityUserFlow-id/languages/:userFlowLanguageConfiguration-id/defaultPages
  • GETList overrides pages/identity/b2xUserFlows/:b2xIdentityUserFlow-id/languages/:userFlowLanguageConfiguration-id/overridesPagesGet the userFlowLanguagePage resources from the overridesPages navigation property. These pages are used to customize the values shown to the user during a…
  • POSTCreate overrides page/identity/b2xUserFlows/:b2xIdentityUserFlow-id/languages/:userFlowLanguageConfiguration-id/overridesPages
  • POSTUpload client certificate (post federation signup)/identity/b2xUserFlows/:b2xIdentityUserFlow-id/apiConnectorConfiguration/postFederationSignup/uploadClientCertificateUpload a PKCS 12 format key (.pfx) to an API connector's authentication configuration. The input is a base-64 encoded value of the PKCS 12 certificate…

Identity: api connectors

  • GETList api connectors/identity/apiConnectorsRead the properties of an identityApiConnector object.
  • POSTCreate api connector/identity/apiConnectorsCreate a new identityApiConnector object.
  • GETGet api connector/identity/apiConnectors/:identityApiConnector-idRead the properties of an identityApiConnector object.
  • DELETEDelete api connector/identity/apiConnectors/:identityApiConnector-idDelete an identityApiConnector object.
  • PATCHUpdate api connector/identity/apiConnectors/:identityApiConnector-idUpdate the properties of an identityApiConnector object.
  • POSTUpload client certificate (api connector)/identity/apiConnectors/:identityApiConnector-id/uploadClientCertificateUpload a PKCS 12 format key (.pfx) to an API connector's authentication configuration. The input is a base-64 encoded value of the PKCS 12 certificate…

Identity: risk prevention

  • GETGet risk prevention/identity/riskPreventionRepresents the entry point for fraud and risk prevention configurations in Microsoft Entra External ID, including third-party provider settings.
  • DELETEDelete risk prevention/identity/riskPrevention
  • PATCHUpdate risk prevention/identity/riskPrevention
  • GETList fraud protection providers/identity/riskPrevention/fraudProtectionProvidersGet a list of the fraudProtectionProvider object and their properties. The following derived types are supported:
  • POSTCreate fraud protection provider/identity/riskPrevention/fraudProtectionProvidersCreate a new fraudProtectionProvider object. You can create one of the following subtypes that are derived from fraudProtectionProvider.
  • GETList web application firewall providers/identity/riskPrevention/webApplicationFirewallProvidersGet a list of the webApplicationFirewallProvider objects and their properties.
  • POSTCreate web application firewall provider/identity/riskPrevention/webApplicationFirewallProvidersCreate a new webApplicationFirewallProvider object. You can create one of the following subtypes that are derived from webApplicationFirewallProvider.
  • GETList web application firewall verifications/identity/riskPrevention/webApplicationFirewallVerificationsGet a list of the webApplicationFirewallVerificationModel objects and their properties.
  • POSTCreate web application firewall verification/identity/riskPrevention/webApplicationFirewallVerifications
  • GETGet fraud protection provider/identity/riskPrevention/fraudProtectionProviders/:fraudProtectionProvider-idRead the properties and relationships of fraudProtectionProvider object. The following derived types are currently supported.
  • DELETEDelete fraud protection provider/identity/riskPrevention/fraudProtectionProviders/:fraudProtectionProvider-idDelete a fraudProtectionProvider object.
  • PATCHUpdate fraud protection provider/identity/riskPrevention/fraudProtectionProviders/:fraudProtectionProvider-idUpdate the properties of a fraudProtectionProvider object. The following derived types are currently supported.
  • GETGet web application firewall provider/identity/riskPrevention/webApplicationFirewallProviders/:webApplicationFirewallProvider-idRead the properties and relationships of webApplicationFirewallProvider object.
  • DELETEDelete web application firewall provider/identity/riskPrevention/webApplicationFirewallProviders/:webApplicationFirewallProvider-idDelete a webApplicationFirewallProvider object.
  • PATCHUpdate web application firewall provider/identity/riskPrevention/webApplicationFirewallProviders/:webApplicationFirewallProvider-idUpdate the properties of a webApplicationFirewallProvider object.
  • GETGet web application firewall verification/identity/riskPrevention/webApplicationFirewallVerifications/:webApplicationFirewallVerificationModel-idRead the properties and relationships of webApplicationFirewallVerificationModel object.
  • DELETEDelete web application firewall verification/identity/riskPrevention/webApplicationFirewallVerifications/:webApplicationFirewallVerificationModel-idDelete a webApplicationFirewallVerificationModel object.
  • PATCHUpdate web application firewall verification/identity/riskPrevention/webApplicationFirewallVerifications/:webApplicationFirewallVerificationModel-id
  • POSTCreate verify/identity/riskPrevention/webApplicationFirewallProviders/:webApplicationFirewallProvider-id/verifyInitiate a verification operation for a webApplicationFirewallProvider object. This API triggers provider-specific verification logic and returns a…
  • GETGet provider/identity/riskPrevention/webApplicationFirewallVerifications/:webApplicationFirewallVerificationModel-id/providerReference to a provider resource associated with this verification model. Represents a WAF provider that can be used to verify or manage the host.

Identity: identity providers

  • GETList identity providers/identity/identityProvidersGet a collection of identity provider resources that are configured for a tenant, and that are derived from identityProviderBase. For a Microsoft Entra…
  • POSTCreate identity provider/identity/identityProvidersCreate an identity provider object that is of the type specified in the request body. Among the types of providers derived from identityProviderBase, you can…
  • GETAvailable provider types (identity provider)/identity/identityProviders/availableProviderTypes()Get all identity providers supported in a directory.
  • GETGet identity provider/identity/identityProviders/:identityProviderBase-idGet the properties and relationships of the specified identity provider configured in the tenant. Among the types of providers derived from…
  • DELETEDelete identity provider/identity/identityProviders/:identityProviderBase-idDelete an identity provider resource that is of the type specified by the id in the request. Among the types of providers derived from identityProviderBase,…
  • PATCHUpdate identity provider/identity/identityProviders/:identityProviderBase-idUpdate the properties of the specified identity provider configured in the tenant. Among the types of providers derived from identityProviderBase, you can…

Identity: user flow attributes

  • GETList user flow attributes/identity/userFlowAttributesRetrieve a list of identityUserFlowAttribute objects.
  • POSTCreate user flow attribute/identity/userFlowAttributesCreate a new custom identityUserFlowAttribute object.
  • GETGet user flow attribute/identity/userFlowAttributes/:identityUserFlowAttribute-idRetrieve the properties and relationships of a identityUserFlowAttribute object.
  • DELETEDelete user flow attribute/identity/userFlowAttributes/:identityUserFlowAttribute-idDelete a custom identityUserFlowAttribute.
  • PATCHUpdate user flow attribute/identity/userFlowAttributes/:identityUserFlowAttribute-idUpdate the properties of a custom identityUserFlowAttribute object.

Policies: authorization policy

  • GETGet authorization policy/policies/authorizationPolicyRetrieve the properties of an authorizationPolicy object.
  • DELETEDelete authorization policy/policies/authorizationPolicy
  • PATCHUpdate authorization policy/policies/authorizationPolicyUpdate the properties of an authorizationPolicy object.

Identity protection: risky users

  • GETList risky users/identityProtection/riskyUsersGet a list of the riskyUser objects and their properties.
  • POSTCreate risky user/identityProtection/riskyUsers
  • POSTDismiss risky user/identityProtection/riskyUsers/dismissDismiss the risk of one or more riskyUser objects. This action sets the targeted user's risk level to none.
  • POSTCreate confirm safe/identityProtection/riskyUsers/confirmSafeConfirm one or more riskyUser objects as safe. This action sets the targeted user's risk level to none.
  • POSTCreate confirm compromised/identityProtection/riskyUsers/confirmCompromisedConfirm one or more riskyUser objects as compromised. This action sets the targeted user's risk level to high.
  • GETGet risky user/identityProtection/riskyUsers/:riskyUser-idRead the properties and relationships of a riskyUser object.
  • DELETEDelete risky user/identityProtection/riskyUsers/:riskyUser-id
  • PATCHUpdate risky user/identityProtection/riskyUsers/:riskyUser-id
  • GETGet history/identityProtection/riskyUsers/:riskyUser-id/historyGet the riskyUserHistoryItems from the history navigation property.
  • POSTCreate history/identityProtection/riskyUsers/:riskyUser-id/history
  • GETGet history/identityProtection/riskyUsers/:riskyUser-id/history/:riskyUserHistoryItem-idThe activity related to user risk level change
  • DELETEDelete history/identityProtection/riskyUsers/:riskyUser-id/history/:riskyUserHistoryItem-id
  • PATCHUpdate history/identityProtection/riskyUsers/:riskyUser-id/history/:riskyUserHistoryItem-id

Policies: app management policies

  • GETList app management policies/policies/appManagementPoliciesRetrieve a list of appManagementPolicy objects.
  • POSTCreate app management policy/policies/appManagementPoliciesCreate an appManagementPolicy object.
  • GETGet app management policy/policies/appManagementPolicies/:appManagementPolicy-idRead the properties of an appManagementPolicy object.
  • DELETEDelete app management policy/policies/appManagementPolicies/:appManagementPolicy-idDelete an appManagementPolicy object.
  • PATCHUpdate app management policy/policies/appManagementPolicies/:appManagementPolicy-idUpdate an appManagementPolicy object.
  • GETGet applies to/policies/appManagementPolicies/:appManagementPolicy-id/appliesToList application and service principal objects that are assigned an appManagementPolicy policy object.
  • GETGet applies to/policies/appManagementPolicies/:appManagementPolicy-id/appliesTo/:directoryObject-idCollection of applications and service principals to which the policy is applied.

Policies: claims mapping policies

  • GETList claims mapping policies/policies/claimsMappingPoliciesGet a list of claimsMappingPolicy objects.
  • POSTCreate claims mapping policy/policies/claimsMappingPoliciesCreate a new claimsMappingPolicy object.
  • GETGet claims mapping policy/policies/claimsMappingPolicies/:claimsMappingPolicy-idRetrieve the properties and relationships of a claimsMappingPolicy object.
  • DELETEDelete claims mapping policy/policies/claimsMappingPolicies/:claimsMappingPolicy-idDelete a claimsMappingPolicy object.
  • PATCHUpdate claims mapping policy/policies/claimsMappingPolicies/:claimsMappingPolicy-idUpdate the properties of a claimsMappingPolicy object.
  • GETGet applies to/policies/claimsMappingPolicies/:claimsMappingPolicy-id/appliesToGet a list of directoryObject objects that a claimsMappingPolicy object has been applied to. The claimsMappingPolicy can only be applied to application and…
  • GETGet applies to/policies/claimsMappingPolicies/:claimsMappingPolicy-id/appliesTo/:directoryObject-id

Policies: token issuance policies

  • GETList token issuance policies/policies/tokenIssuancePoliciesGet a list of tokenIssuancePolicy objects.
  • POSTCreate token issuance policy/policies/tokenIssuancePoliciesCreate a new tokenIssuancePolicy object.
  • GETGet token issuance policy/policies/tokenIssuancePolicies/:tokenIssuancePolicy-idThe policy that specifies the characteristics of SAML tokens issued by Microsoft Entra ID.
  • DELETEDelete token issuance policy/policies/tokenIssuancePolicies/:tokenIssuancePolicy-idDelete a tokenIssuancePolicy object.
  • PATCHUpdate token issuance policy/policies/tokenIssuancePolicies/:tokenIssuancePolicy-idUpdate the properties of a tokenIssuancePolicy object.
  • GETGet applies to/policies/tokenIssuancePolicies/:tokenIssuancePolicy-id/appliesToGet a list of directoryObject objects that a tokenIssuancePolicy object has been applied to. The tokenIssuancePolicy can only be applied to application.
  • GETGet applies to/policies/tokenIssuancePolicies/:tokenIssuancePolicy-id/appliesTo/:directoryObject-id

Policies: token lifetime policies

  • GETList token lifetime policies/policies/tokenLifetimePoliciesGet a list of tokenLifetimePolicy objects.
  • POSTCreate token lifetime policy/policies/tokenLifetimePoliciesCreate a new tokenLifetimePolicy object.
  • GETGet token lifetime policy/policies/tokenLifetimePolicies/:tokenLifetimePolicy-idRetrieve the properties and relationships of a tokenLifetimePolicy object.
  • DELETEDelete token lifetime policy/policies/tokenLifetimePolicies/:tokenLifetimePolicy-idDelete a tokenLifetimePolicy object.
  • PATCHUpdate token lifetime policy/policies/tokenLifetimePolicies/:tokenLifetimePolicy-idUpdate the properties of a tokenLifetimePolicy object.
  • GETGet applies to/policies/tokenLifetimePolicies/:tokenLifetimePolicy-id/appliesToGet a list of directoryObject objects that a tokenLifetimePolicy object has been applied to. The tokenLifetimePolicy can only be applied to application.
  • GETGet applies to/policies/tokenLifetimePolicies/:tokenLifetimePolicy-id/appliesTo/:directoryObject-id

Policies: feature rollout policies

  • GETList feature rollout policies/policies/featureRolloutPoliciesRetrieve a list of featureRolloutPolicy objects.
  • POSTCreate feature rollout policy/policies/featureRolloutPoliciesCreate a new featureRolloutPolicy object.
  • GETGet feature rollout policy/policies/featureRolloutPolicies/:featureRolloutPolicy-idRetrieve the properties and relationships of a featureRolloutPolicy object.
  • DELETEDelete feature rollout policy/policies/featureRolloutPolicies/:featureRolloutPolicy-idDelete a featureRolloutPolicy object.
  • PATCHUpdate feature rollout policy/policies/featureRolloutPolicies/:featureRolloutPolicy-idUpdate the properties of featureRolloutPolicy object.
  • GETGet applies to/policies/featureRolloutPolicies/:featureRolloutPolicy-id/appliesToNullable. Specifies a list of directoryObject resources that feature is enabled for.
  • POSTCreate applies to/policies/featureRolloutPolicies/:featureRolloutPolicy-id/appliesToAdd an appliesTo on a featureRolloutPolicy object to specify the directoryObject to which the featureRolloutPolicy should be applied.
  • GETList feature rollout policies references/policies/featureRolloutPolicies/:featureRolloutPolicy-id/appliesTo/$refNullable. Specifies a list of directoryObject resources that feature is enabled for.
  • POSTAdd feature rollout policy reference/policies/featureRolloutPolicies/:featureRolloutPolicy-id/appliesTo/$refAdd an appliesTo on a featureRolloutPolicy object to specify the directoryObject to which the featureRolloutPolicy should be applied.
  • DELETERemove feature rollout policy reference/policies/featureRolloutPolicies/:featureRolloutPolicy-id/appliesTo/$ref?@id=stringRemove an appliesTo on a featureRolloutPolicy object to remove the directoryObject from feature rollout.
  • DELETERemove feature rollout policy reference/policies/featureRolloutPolicies/:featureRolloutPolicy-id/appliesTo/:directoryObject-id/$refRemove an appliesTo on a featureRolloutPolicy object to remove the directoryObject from feature rollout.

Policies: role management policies

  • GETList role management policies/policies/roleManagementPoliciesGet the details of the policies in PIM that can be applied to Microsoft Entra roles or group membership or ownership. To retrieve policies that apply to Azure…
  • POSTCreate role management policy/policies/roleManagementPolicies
  • GETGet role management policy/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-idRetrieve the details of a role management policy.
  • DELETEDelete role management policy/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-id
  • PATCHUpdate role management policy/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-id
  • GETList rules/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-id/rulesGet the rules or settings defined for a role management policy. The rules are a collection of following types that are derived from the…
  • POSTCreate rule/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-id/rules
  • GETList effective rules/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-id/effectiveRulesThe list of effective rules like approval rules and expiration rules evaluated based on inherited referenced rules. For example, if there is a tenant-wide…
  • POSTCreate effective rule/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-id/effectiveRules
  • GETGet rule/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-id/rules/:unifiedRoleManagementPolicyRule-idRetrieve a rule or settings defined for a role management policy. The rule can be one of the following types that are derived from the…
  • DELETEDelete rule/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-id/rules/:unifiedRoleManagementPolicyRule-id
  • PATCHUpdate rule/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-id/rules/:unifiedRoleManagementPolicyRule-idUpdate a rule defined for a role management policy. The rule can be one of the following types that are derived from the unifiedRoleManagementPolicyRule…
  • GETGet effective rule/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-id/effectiveRules/:unifiedRoleManagementPolicyRule-idThe list of effective rules like approval rules and expiration rules evaluated based on inherited referenced rules. For example, if there is a tenant-wide…
  • DELETEDelete effective rule/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-id/effectiveRules/:unifiedRoleManagementPolicyRule-id
  • PATCHUpdate effective rule/policies/roleManagementPolicies/:unifiedRoleManagementPolicy-id/effectiveRules/:unifiedRoleManagementPolicyRule-id

Policies: cross tenant access policy

  • GETGet cross tenant access policy/policies/crossTenantAccessPolicyRead the properties and relationships of a crossTenantAccessPolicy object.
  • DELETEDelete cross tenant access policy/policies/crossTenantAccessPolicy
  • PATCHUpdate cross tenant access policy/policies/crossTenantAccessPolicyUpdate the properties of a cross-tenant access policy.
  • GETGet default/policies/crossTenantAccessPolicy/defaultRead the default configuration of a cross-tenant access policy. This default configuration may be the service default assigned by Microsoft Entra ID…
  • DELETEDelete default/policies/crossTenantAccessPolicy/default
  • PATCHUpdate default/policies/crossTenantAccessPolicy/defaultUpdate the default configuration of a cross-tenant access policy.
  • GETList partners/policies/crossTenantAccessPolicy/partnersGet a list of all partner configurations within a cross-tenant access policy. You can also use the $expand parameter to list the user synchronization policy…
  • POSTCreate partner/policies/crossTenantAccessPolicy/partnersCreate a new partner configuration in a cross-tenant access policy.
  • GETList templates/policies/crossTenantAccessPolicy/templatesRepresents the base policy in the directory for multitenant organization settings.
  • DELETEDelete templates/policies/crossTenantAccessPolicy/templates
  • PATCHUpdate templates/policies/crossTenantAccessPolicy/templates
  • GETList m365 capabilities/policies/crossTenantAccessPolicy/default/m365CapabilitiesGet a list of Microsoft 365 cross-tenant capabilities configured for the default cross-tenant access policy. The returned collection is a heterogeneous…
  • POSTCreate m365 capability/policies/crossTenantAccessPolicy/default/m365CapabilitiesCreate a new Microsoft 365 cross-tenant capability for the default cross-tenant access policy. The @odata.type property in the request body is required to…
  • POSTReset to system default (default)/policies/crossTenantAccessPolicy/default/resetToSystemDefaultReset any changes made to the default configuration in a cross-tenant access policy back to the system default.
  • GETGet multi tenant organization partner configuration/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerConfigurationGet the cross-tenant access policy template with inbound and outbound partner configuration settings for a multitenant organization.
  • DELETEDelete multi tenant organization partner configuration/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerConfiguration
  • PATCHUpdate multi tenant organization partner configuration/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerConfigurationUpdate the cross-tenant access policy template with inbound and outbound partner configuration settings for a multitenant organization.
  • GETGet multi tenant organization identity synchronization/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentitySynchronizationGet the cross-tenant access policy template with user synchronization settings for a multitenant organization.
  • DELETEDelete multi tenant organization identity synchronization/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentitySynchronization
  • PATCHUpdate multi tenant organization identity synchronization/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentitySynchronizationUpdate the cross-tenant access policy template with user synchronization settings for a multitenant organization.
  • GETGet partner/policies/crossTenantAccessPolicy/partners/:crossTenantAccessPolicyConfigurationPartner-tenantIdRead the properties and relationships of a partner-specific configuration.
  • DELETEDelete partner/policies/crossTenantAccessPolicy/partners/:crossTenantAccessPolicyConfigurationPartner-tenantIdDelete a partner-specific configuration in a cross-tenant access policy. If a configuration includes a user synchronization policy, you must first delete the…
  • PATCHUpdate partner/policies/crossTenantAccessPolicy/partners/:crossTenantAccessPolicyConfigurationPartner-tenantIdUpdate the properties of a partner-specific configuration.
  • POSTReset to default settings (multi tenant organization partner configuration)/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationPartnerConfiguration/resetToDefaultSettingsReset the cross-tenant access policy template with inbound and outbound partner configuration settings for a multitenant organization to the default values.…
  • POSTReset to default settings (multi tenant organization identity synchronization)/policies/crossTenantAccessPolicy/templates/multiTenantOrganizationIdentitySynchronization/resetToDefaultSettingsReset the cross-tenant access policy template with user synchronization settings for a multitenant organization to the default values. In its reset state, the…
  • GETGet m365 capability/policies/crossTenantAccessPolicy/default/m365Capabilities/:m365CapabilityBase-nameDefines the default Microsoft 365 cross-tenant capabilities for inbound access from external organizations.
  • DELETEDelete m365 capability/policies/crossTenantAccessPolicy/default/m365Capabilities/:m365CapabilityBase-name
  • PATCHUpdate m365 capability/policies/crossTenantAccessPolicy/default/m365Capabilities/:m365CapabilityBase-nameUpdate an existing Microsoft 365 cross-tenant capability for the default cross-tenant access policy.
  • GETList m365 capabilities/policies/crossTenantAccessPolicy/partners/:crossTenantAccessPolicyConfigurationPartner-tenantId/m365CapabilitiesGet a list of Microsoft 365 cross-tenant capabilities configured for a partner organization in the cross-tenant access policy. The returned collection is a…
  • POSTCreate m365 capability/policies/crossTenantAccessPolicy/partners/:crossTenantAccessPolicyConfigurationPartner-tenantId/m365CapabilitiesCreate a new Microsoft 365 cross-tenant capability for a partner organization in the cross-tenant access policy. The @odata.type property in the request body…
  • GETGet identity synchronization/policies/crossTenantAccessPolicy/partners/:crossTenantAccessPolicyConfigurationPartner-tenantId/identitySynchronizationGet the user synchronization policy of a partner-specific configuration.
  • PUTReplace identity synchronization/policies/crossTenantAccessPolicy/partners/:crossTenantAccessPolicyConfigurationPartner-tenantId/identitySynchronizationCreate a cross-tenant user synchronization policy for a partner-specific configuration.
  • DELETEDelete identity synchronization/policies/crossTenantAccessPolicy/partners/:crossTenantAccessPolicyConfigurationPartner-tenantId/identitySynchronizationDelete the user synchronization policy for a partner-specific configuration.
  • GETList service provider constraints/policies/crossTenantAccessPolicy/partners/:crossTenantAccessPolicyConfigurationPartner-tenantId/serviceProviderConstraints
  • DELETEDelete service provider constraints/policies/crossTenantAccessPolicy/partners/:crossTenantAccessPolicyConfigurationPartner-tenantId/serviceProviderConstraints
  • PATCHUpdate service provider constraints/policies/crossTenantAccessPolicy/partners/:crossTenantAccessPolicyConfigurationPartner-tenantId/serviceProviderConstraints

Policies: permission grant policies

  • GETList permission grant policies/policies/permissionGrantPoliciesRetrieve the list of permissionGrantPolicy objects.
  • POSTCreate permission grant policy/policies/permissionGrantPoliciesCreates a permissionGrantPolicy. A permission grant policy is used to describe the conditions under which permissions can be granted (for example, during…
  • GETGet permission grant policy/policies/permissionGrantPolicies/:permissionGrantPolicy-idRetrieve a single permissionGrantPolicy object.
  • DELETEDelete permission grant policy/policies/permissionGrantPolicies/:permissionGrantPolicy-idDelete a permissionGrantPolicy object.
  • PATCHUpdate permission grant policy/policies/permissionGrantPolicies/:permissionGrantPolicy-idUpdate properties of a permissionGrantPolicy.
  • GETList excludes/policies/permissionGrantPolicies/:permissionGrantPolicy-id/excludesRetrieve the condition sets which are *excluded* in a permissionGrantPolicy.
  • POSTCreate exclude/policies/permissionGrantPolicies/:permissionGrantPolicy-id/excludesAdd conditions under which a permission grant event is *excluded* in a permission grant policy. You do this by adding a permissionGrantConditionSet to the…
  • GETList includes/policies/permissionGrantPolicies/:permissionGrantPolicy-id/includesRetrieve the condition sets which are *included* in a permissionGrantPolicy.
  • POSTCreate include/policies/permissionGrantPolicies/:permissionGrantPolicy-id/includesAdd conditions under which a permission grant event is *included* in a permission grant policy. You do this by adding a permissionGrantConditionSet to the…
  • GETGet exclude/policies/permissionGrantPolicies/:permissionGrantPolicy-id/excludes/:permissionGrantConditionSet-idCondition sets that are excluded in this permission grant policy. Automatically expanded on GET.
  • DELETEDelete exclude/policies/permissionGrantPolicies/:permissionGrantPolicy-id/excludes/:permissionGrantConditionSet-idDeletes a permissionGrantConditionSet from the excludes collection of a permissionGrantPolicy.
  • PATCHUpdate exclude/policies/permissionGrantPolicies/:permissionGrantPolicy-id/excludes/:permissionGrantConditionSet-id
  • GETGet include/policies/permissionGrantPolicies/:permissionGrantPolicy-id/includes/:permissionGrantConditionSet-idCondition sets that are included in this permission grant policy. Automatically expanded on GET.
  • DELETEDelete include/policies/permissionGrantPolicies/:permissionGrantPolicy-id/includes/:permissionGrantConditionSet-idDeletes a permissionGrantConditionSet from the includes collection of a permissionGrantPolicy.
  • PATCHUpdate include/policies/permissionGrantPolicies/:permissionGrantPolicy-id/includes/:permissionGrantConditionSet-id

Identity protection: risk detections

  • GETList risk detections/identityProtection/riskDetectionsGet a list of the riskDetection objects and their properties.
  • POSTCreate risk detection/identityProtection/riskDetections
  • GETGet risk detection/identityProtection/riskDetections/:riskDetection-idRead the properties and relationships of a riskDetection object.
  • DELETEDelete risk detection/identityProtection/riskDetections/:riskDetection-id
  • PATCHUpdate risk detection/identityProtection/riskDetections/:riskDetection-id

Identity: authentication events flows

  • GETList authentication events flows/identity/authenticationEventsFlowsGet a collection of authentication events policies that are derived from authenticationEventsFlow. The following derived subtypes are supported:…
  • POSTCreate authentication events flow/identity/authenticationEventsFlowsCreate a new authenticationEventsFlow object that is of the type specified in the request body. The following derived subtypes are supported:…
  • GETGet external users self service sign up events flow/identity/authenticationEventsFlows/graph.externalUsersSelfServiceSignUpEventsFlow
  • GETGet authentication events flow/identity/authenticationEventsFlows/:authenticationEventsFlow-idRetrieve the properties and relationships of a specific authenticationEventsFlow object by ID. The @odata.type property in the response object indicates the…
  • DELETEDelete authentication events flow/identity/authenticationEventsFlows/:authenticationEventsFlow-idDelete a specific authenticationEventsFlow resource by ID. This operation also removes or unlinks all applications from the flow, which disables the…
  • PATCHUpdate authentication events flow/identity/authenticationEventsFlows/:authenticationEventsFlow-idUpdate the properties of an authenticationEventsFlow object by ID. You must specify the @odata.type property and the value of the authenticationEventsFlow…
  • GETList conditions/identity/authenticationEventsFlows/:authenticationEventsFlow-id/conditionsThe conditions representing the context of the authentication request that's used to decide whether the events policy is invoked. Supports $filter (eq). See…
  • GETGet external users self service sign up events flow/identity/authenticationEventsFlows/:authenticationEventsFlow-id/graph.externalUsersSelfServiceSignUpEventsFlow
  • GETList conditions/identity/authenticationEventsFlows/:authenticationEventsFlow-id/graph.externalUsersSelfServiceSignUpEventsFlow/conditionsThe conditions representing the context of the authentication request that's used to decide whether the events policy is invoked. Supports $filter (eq). See…
  • GETGet on attribute collection/identity/authenticationEventsFlows/:authenticationEventsFlow-id/graph.externalUsersSelfServiceSignUpEventsFlow/onAttributeCollectionThe configuration for what to invoke when attributes are ready to be collected from the user.
  • GETGet on authentication method load start/identity/authenticationEventsFlows/:authenticationEventsFlow-id/graph.externalUsersSelfServiceSignUpEventsFlow/onAuthenticationMethodLoadStartRequired. The configuration for what to invoke when authentication methods are ready to be presented to the user. Must have at least one identity provider…
  • GETList include applications/identity/authenticationEventsFlows/:authenticationEventsFlow-id/conditions/applications/includeApplicationsList the applications linked to an external identities self-service sign up user flow that's represented by an externalUsersSelfServiceSignupEventsFlow…
  • POSTCreate include application/identity/authenticationEventsFlows/:authenticationEventsFlow-id/conditions/applications/includeApplicationsAdd or link an application to a user flow, or authenticationEventsFlow. This enables the authentication experience defined by the user flow to be enabled for…

Policies: admin consent request policy

  • GETGet admin consent request policy/policies/adminConsentRequestPolicyRead the properties and relationships of an adminConsentRequestPolicy object.
  • DELETEDelete admin consent request policy/policies/adminConsentRequestPolicy
  • PATCHUpdate admin consent request policy/policies/adminConsentRequestPolicyUpdate the properties of an adminConsentRequestPolicy object.

Policies: authentication flows policy

  • GETGet authentication flows policy/policies/authenticationFlowsPolicyRead the properties and relationships of an authenticationFlowsPolicy object.
  • DELETEDelete authentication flows policy/policies/authenticationFlowsPolicy
  • PATCHUpdate authentication flows policy/policies/authenticationFlowsPolicyUpdate the selfServiceSignUp property of an authenticationFlowsPolicy object. The properties id, type, and description cannot be modified.

Policies: conditional access policies

  • GETList conditional access policies/policies/conditionalAccessPoliciesThe custom rules that define an access scenario.
  • POSTCreate conditional access policy/policies/conditionalAccessPolicies
  • GETGet conditional access policy/policies/conditionalAccessPolicies/:conditionalAccessPolicy-idThe custom rules that define an access scenario.
  • DELETEDelete conditional access policy/policies/conditionalAccessPolicies/:conditionalAccessPolicy-id
  • PATCHUpdate conditional access policy/policies/conditionalAccessPolicies/:conditionalAccessPolicy-id
  • POSTRestore conditional access policy/policies/conditionalAccessPolicies/:conditionalAccessPolicy-id/restore

Policies: default app management policy

  • GETGet default app management policy/policies/defaultAppManagementPolicyRead the properties of a tenantAppManagementPolicy object.
  • DELETEDelete default app management policy/policies/defaultAppManagementPolicy
  • PATCHUpdate default app management policy/policies/defaultAppManagementPolicyUpdate the properties of a tenantAppManagementPolicy object.

Policies: home realm discovery policies

  • GETList home realm discovery policies/policies/homeRealmDiscoveryPoliciesGet a list of homeRealmDiscoveryPolicy objects.
  • POSTCreate home realm discovery policy/policies/homeRealmDiscoveryPoliciesCreate a new homeRealmDiscoveryPolicy object.
  • GETGet home realm discovery policy/policies/homeRealmDiscoveryPolicies/:homeRealmDiscoveryPolicy-idRetrieve the properties and relationships of a homeRealmDiscoveryPolicy object.
  • DELETEDelete home realm discovery policy/policies/homeRealmDiscoveryPolicies/:homeRealmDiscoveryPolicy-idDelete a homeRealmDiscoveryPolicy object.
  • PATCHUpdate home realm discovery policy/policies/homeRealmDiscoveryPolicies/:homeRealmDiscoveryPolicy-idUpdate the properties of a homeRealmDiscoveryPolicy object.
  • GETGet applies to/policies/homeRealmDiscoveryPolicies/:homeRealmDiscoveryPolicy-id/appliesToGet a list of directoryObject objects that a homeRealmDiscoveryPolicy object has been applied to.
  • GETGet applies to/policies/homeRealmDiscoveryPolicies/:homeRealmDiscoveryPolicy-id/appliesTo/:directoryObject-id

Policies: authentication methods policy

  • GETGet authentication methods policy/policies/authenticationMethodsPolicyRead the properties and relationships of an authenticationMethodsPolicy object.
  • DELETEDelete authentication methods policy/policies/authenticationMethodsPolicy
  • PATCHUpdate authentication methods policy/policies/authenticationMethodsPolicyUpdate the properties of an authenticationMethodsPolicy object.
  • GETList authentication method configurations/policies/authenticationMethodsPolicy/authenticationMethodConfigurationsRead the properties and relationships of an externalAuthenticationMethodConfiguration object.
  • POSTCreate authentication method configuration/policies/authenticationMethodsPolicy/authenticationMethodConfigurations
  • GETGet authentication method configuration/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/:authenticationMethodConfiguration-idRead the properties and relationships of an externalAuthenticationMethodConfiguration object.
  • DELETEDelete authentication method configuration/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/:authenticationMethodConfiguration-idDelete an externalAuthenticationMethodConfiguration object.
  • PATCHUpdate authentication method configuration/policies/authenticationMethodsPolicy/authenticationMethodConfigurations/:authenticationMethodConfiguration-idUpdate the properties of an externalAuthenticationMethodConfiguration object.

Identity: authentication event listeners

  • GETList authentication event listeners/identity/authenticationEventListenersGet a list of the authenticationEventListener objects and their properties. The following derived types are supported:
  • POSTCreate authentication event listener/identity/authenticationEventListenersCreate a new authenticationEventListener object. You can create one of the following subtypes that are derived from authenticationEventListener.
  • GETGet authentication event listener/identity/authenticationEventListeners/:authenticationEventListener-idRead the properties and relationships of an authenticationEventListener object. The @odata.type property in the response object indicates the type of the…
  • DELETEDelete authentication event listener/identity/authenticationEventListeners/:authenticationEventListener-idDelete an authenticationEventListener object. The following derived types are currently supported.
  • PATCHUpdate authentication event listener/identity/authenticationEventListeners/:authenticationEventListener-idUpdate the properties of an authenticationEventListener object. You must specify the @odata.type property and the value of the authenticationEventListener…

Policies: activity based timeout policies

  • GETList activity based timeout policies/policies/activityBasedTimeoutPoliciesGet a list of activityBasedTimeoutPolicy objects.
  • POSTCreate activity based timeout policy/policies/activityBasedTimeoutPoliciesCreate a new activityBasedTimeoutPolicy object.
  • GETGet activity based timeout policy/policies/activityBasedTimeoutPolicies/:activityBasedTimeoutPolicy-idGet the properties of an activityBasedTimeoutPolicy object.
  • DELETEDelete activity based timeout policy/policies/activityBasedTimeoutPolicies/:activityBasedTimeoutPolicy-idDelete an activityBasedTimeoutPolicy object.
  • PATCHUpdate activity based timeout policy/policies/activityBasedTimeoutPolicies/:activityBasedTimeoutPolicy-idUpdate the properties of an activityBasedTimeoutPolicy object.
  • GETGet applies to/policies/activityBasedTimeoutPolicies/:activityBasedTimeoutPolicy-id/appliesTo
  • GETGet applies to/policies/activityBasedTimeoutPolicies/:activityBasedTimeoutPolicy-id/appliesTo/:directoryObject-id

Identity: custom authentication extensions

  • GETList custom authentication extensions/identity/customAuthenticationExtensionsGet a list of the customAuthenticationExtension objects and their properties. The following derived types are supported.
  • POSTCreate custom authentication extension/identity/customAuthenticationExtensionsCreate a new customAuthenticationExtension object. The following derived types are currently supported.
  • POSTValidate authentication configuration (custom authentication extension)/identity/customAuthenticationExtensions/validateAuthenticationConfiguration
  • GETGet custom authentication extension/identity/customAuthenticationExtensions/:customAuthenticationExtension-idRead the properties and relationships of a customAuthenticationExtension object. The following derived types are currently supported.
  • DELETEDelete custom authentication extension/identity/customAuthenticationExtensions/:customAuthenticationExtension-idDelete a customAuthenticationExtension object. The following derived types are currently supported.

Showing 300 of 400 endpoints. Fork the collection to see all of them.

API details

Base URL
https://graph.microsoft.com/v1.0
Authentication
OAuth 2.0 (authorization code, client credentials flows)
Operations
400 operations on 191 pathsGET 167POST 80DELETE 76PATCH 74PUT 3
8 marked deprecated
Main resources
Identity: conditional access 52Identity: b2x user flows 42Policies: cross tenant access policy 36Identity: risk prevention 20Policies: permission grant policies 15Policies: role management policies 15Identity protection: risky users 13Identity: authentication events flows 13Identity protection: risky service principals 12Policies: authentication strength policies 12
Description format
OpenAPI 3.0.4, API version v1.0

How to test the Microsoft Graph: Identity, sign-in and policies in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Microsoft Graph: Identity, sign-in and policies collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code, client credentials flows). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Get identity” (GET /identity), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Microsoft Graph: Identity, sign-in and policies?

Configure conditional access and authentication policies, authentication method settings, identity providers, user flows and risk detection (Identity… It is listed under Identity & security and has 400 endpoints.

Who publishes the Microsoft Graph: Identity, sign-in and policies?

It is listed from Microsoft's public API description (an OpenAPI document), not published by Microsoft on Swastik Codes. Anyone who controls microsoft.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Microsoft Graph: Identity, sign-in and policies?

Requests go to https://graph.microsoft.com/v1.0. Endpoint paths are added to this base URL.

How do I authenticate with the Microsoft Graph: Identity, sign-in and policies?

With OAuth 2.0 (authorization code, client credentials flows).

How many endpoints does the Microsoft Graph: Identity, sign-in and policies have?

400 operations on 191 paths (167 GET, 80 POST, 76 DELETE, 74 PATCH, 3 PUT). The largest groups are Identity: conditional access, Identity: b2x user flows, Policies: cross tenant access policy, Identity: risk prevention.

Is forking the Microsoft Graph: Identity, sign-in and policies free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.