# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Identity.SignIns Identity.b2x Identity User Flow API version: 1.0.0 extends: openapi/azure-ad-identity-b2xidentityuserflow-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-01' generator: build-phrasing.py label: Generated by API Evangelist operations: 63 - target: $.paths['/identity/b2xUserFlows'].get update: x-apievangelist-phrasing: intent: List B2X self-service sign-up user flows effect: read questions: - Which self-service sign-up user flows are set up for guests in my Entra tenant? - Can I filter my B2X user flows by a property value? instructions: - text: List all B2X sign-up user flows in the tenant. - text: Show B2X user flows matching {filter}, top {top} only. slots: filter: query.$filter top: query.$top method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows'].post update: x-apievangelist-phrasing: intent: Create a B2X self-service sign-up user flow effect: write questions: - How do I create a new self-service sign-up flow for external guests? - Can I choose identity providers and languages when creating a B2X user flow? instructions: - text: Create a new B2X sign-up user flow with identity providers {providers}. slots: providers: requestBody.identityProviders - text: Create a B2X user flow collecting attributes {attributes} with API connectors {connectors}. slots: attributes: requestBody.userAttributeAssignments connectors: requestBody.apiConnectorConfiguration method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}'].get update: x-apievangelist-phrasing: intent: Get one B2X user flow effect: read questions: - What are the settings and relationships of one specific guest sign-up user flow? - Where can I see the full configuration of a single B2X user flow? instructions: - text: Get B2X user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Show the properties of sign-up user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}'].delete update: x-apievangelist-phrasing: intent: Delete a B2X user flow effect: destructive questions: - How do I remove a guest self-service sign-up flow I no longer need? - Can I delete a whole B2X user flow object? instructions: - text: Delete B2X user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Remove the entire sign-up user flow {flow} from the tenant. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}'].patch update: x-apievangelist-phrasing: intent: Update a B2X user flow effect: write questions: - How do I change the settings of an existing B2X sign-up user flow? - Can I change which identity providers an existing user flow offers in one update? instructions: - text: Update B2X user flow {flow} to use identity providers {providers}. slots: flow: path.b2xIdentityUserFlow-id providers: requestBody.identityProviders - text: Patch user flow {flow} with API connector configuration {connectors}. slots: flow: path.b2xIdentityUserFlow-id connectors: requestBody.apiConnectorConfiguration method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration'].get update: x-apievangelist-phrasing: intent: Get the API connectors enabled for a user flow effect: read questions: - Which API connectors are enabled in a B2X user flow? - What API connector configuration does my guest sign-up flow use? instructions: - text: Show the API connector configuration for user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: List which API connectors are enabled on sign-up flow {flow}. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postAttributeCollection'].get update: x-apievangelist-phrasing: intent: Get the post-attribute-collection API connector effect: read questions: - What API connector runs after attributes are collected in my sign-up flow? - Which endpoint is called once a guest submits their sign-up attributes? instructions: - text: Get the post-attribute-collection API connector for user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Show the connector's target URL after attribute collection in flow {flow}. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postAttributeCollection'].delete update: x-apievangelist-phrasing: intent: Delete the post-attribute-collection connector effect: destructive questions: - How do I delete the API connector object that runs after attribute collection? - Can I remove the post-attribute-collection connector entity from a sign-up flow? instructions: - text: Delete the post-attribute-collection API connector from user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Remove the after-attribute-collection connector entity on flow {flow}. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postAttributeCollection'].patch update: x-apievangelist-phrasing: intent: Update the post-attribute-collection connector effect: write questions: - How do I change the target URL of the connector called after attribute collection? - Can I rename the API connector that runs after attributes are collected? instructions: - text: Set the post-attribute-collection connector URL in flow {flow} to {url}. slots: flow: path.b2xIdentityUserFlow-id url: requestBody.targetUrl - text: Rename the after-attribute-collection connector on flow {flow} to {name}. slots: flow: path.b2xIdentityUserFlow-id name: requestBody.displayName method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postAttributeCollection/$ref'].get update: x-apievangelist-phrasing: intent: Get the reference to the post-attribute connector effect: read questions: - What is the reference link to the post-attribute-collection connector in a user flow? - Which connector ID is linked for the post-attribute-collection step? instructions: - text: Get the $ref link for the post-attribute-collection connector of flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Show only the reference ID of the attribute-collection connector on flow {flow}. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postAttributeCollection/$ref'].put update: x-apievangelist-phrasing: intent: Link an API connector to post-attribute collection effect: write questions: - How do I point the post-attribute-collection step at an existing API connector? - Can I swap which existing connector runs after attribute collection? instructions: - text: Link the existing API connector {connector} as post-attribute-collection for flow {flow}. slots: connector: requestBody.@odata.id flow: path.b2xIdentityUserFlow-id - text: Point the after-attribute-collection step of flow {flow} to connector {connector}. slots: flow: path.b2xIdentityUserFlow-id connector: requestBody.@odata.id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postAttributeCollection/$ref'].delete update: x-apievangelist-phrasing: intent: Unlink the post-attribute-collection connector effect: destructive questions: - How do I unlink an API connector from the post-attribute-collection step without deleting it? - Can I detach the attribute-collection connector reference from a user flow? instructions: - text: Unlink the post-attribute-collection connector reference from flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Detach the attribute-collection $ref on flow {flow}, keeping the connector itself. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postAttributeCollection/microsoft.graph.uploadClientCertificate'].post update: x-apievangelist-phrasing: intent: Upload a client certificate to the attribute connector effect: write questions: - How do I upload a .pfx certificate for the post-attribute-collection API connector? - Can the attribute-collection connector authenticate with a PKCS 12 client certificate? instructions: - text: Upload PKCS 12 certificate {pfx} with password {password} to the post-attribute-collection connector of flow {flow}. slots: pfx: requestBody.pkcs12Value password: requestBody.password flow: path.b2xIdentityUserFlow-id - text: Add client cert {pfx} to the attribute-collection connector on flow {flow}. slots: pfx: requestBody.pkcs12Value flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postFederationSignup'].get update: x-apievangelist-phrasing: intent: Get the post-federation-signup API connector effect: read questions: - What API connector runs after a guest signs in with a federated identity provider? - Which endpoint is called right after federated sign-up in my user flow? instructions: - text: Get the post-federation-signup API connector for user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Show the connector that fires after federated sign-in on flow {flow}. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postFederationSignup'].delete update: x-apievangelist-phrasing: intent: Delete the post-federation-signup connector effect: destructive questions: - How do I delete the API connector entity that runs after federated sign-up? - Can I remove the post-federation-signup connector object from a user flow? instructions: - text: Delete the post-federation-signup API connector from user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Remove the after-federation connector entity on sign-up flow {flow}. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postFederationSignup'].patch update: x-apievangelist-phrasing: intent: Update the post-federation-signup connector effect: write questions: - How do I change the target URL of the connector called after federated sign-up? - Can I change authentication settings on the post-federation-signup connector? instructions: - text: Set the post-federation-signup connector URL in flow {flow} to {url}. slots: flow: path.b2xIdentityUserFlow-id url: requestBody.targetUrl - text: Update auth config of the after-federation connector on flow {flow} to {auth}. slots: flow: path.b2xIdentityUserFlow-id auth: requestBody.authenticationConfiguration method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postFederationSignup/$ref'].get update: x-apievangelist-phrasing: intent: Get the reference to the post-federation connector effect: read questions: - What is the reference link to the post-federation-signup connector? - Which connector ID is linked to run after federated sign-up? instructions: - text: Get the $ref link for the post-federation-signup connector of flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Show just the reference ID of the federation-signup connector on flow {flow}. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postFederationSignup/$ref'].put update: x-apievangelist-phrasing: intent: Link an API connector to post-federation signup effect: write questions: - How do I point the post-federation-signup step at an existing API connector? - Can I change which existing connector runs after federated sign-up? instructions: - text: Link the existing API connector {connector} as post-federation-signup for flow {flow}. slots: connector: requestBody.@odata.id flow: path.b2xIdentityUserFlow-id - text: Point the after-federation step of flow {flow} to connector {connector}. slots: flow: path.b2xIdentityUserFlow-id connector: requestBody.@odata.id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postFederationSignup/$ref'].delete update: x-apievangelist-phrasing: intent: Unlink the post-federation-signup connector effect: destructive questions: - How do I unlink the connector from the post-federation-signup step without deleting it? - Can I detach the federation-signup connector reference from a user flow? instructions: - text: Unlink the post-federation-signup connector reference from flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Detach the federation-signup $ref on flow {flow}, keeping the connector itself. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/apiConnectorConfiguration/postFederationSignup/microsoft.graph.uploadClientCertificate'].post update: x-apievangelist-phrasing: intent: Upload a client certificate to the federation connector effect: write questions: - How do I upload a .pfx certificate for the post-federation-signup API connector? - Can the federation-signup connector use a password-protected PKCS 12 certificate? instructions: - text: Upload PKCS 12 certificate {pfx} with password {password} to the post-federation-signup connector of flow {flow}. slots: pfx: requestBody.pkcs12Value password: requestBody.password flow: path.b2xIdentityUserFlow-id - text: Add client cert {pfx} to the federation-signup connector on flow {flow}. slots: pfx: requestBody.pkcs12Value flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/identityProviders'].get update: x-apievangelist-phrasing: intent: List identity providers in a user flow effect: read questions: - Which identity providers can guests sign in with in a given B2X user flow? - What sign-in options does my self-service sign-up flow offer? instructions: - text: List the identity providers included in user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Show identity providers of flow {flow} matching {filter}. slots: flow: path.b2xIdentityUserFlow-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/identityProviders/{identityProvider-id}'].get update: x-apievangelist-phrasing: intent: Get one identity provider in a user flow effect: read questions: - What are the details of one identity provider included in a sign-up flow? - Is a specific identity provider part of a given B2X user flow? instructions: - text: Get identity provider {provider} from user flow {flow}. slots: provider: path.identityProvider-id flow: path.b2xIdentityUserFlow-id - text: Show the details of provider {provider} in sign-up flow {flow}. slots: provider: path.identityProvider-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/identityProviders/$count'].get update: x-apievangelist-phrasing: intent: Count identity providers in a user flow effect: read questions: - How many identity providers are included in a B2X user flow? - What is the number of sign-in providers on one sign-up flow? instructions: - text: Count the identity providers in user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Give me the number of identity providers on flow {flow} matching {filter}. slots: flow: path.b2xIdentityUserFlow-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages'].get update: x-apievangelist-phrasing: intent: List languages configured for a user flow effect: read questions: - Which languages can I customize for my B2X sign-up flow? - What languages are supported for localizing a guest user flow? instructions: - text: List the languages configured for user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Show enabled languages of flow {flow} matching {filter}. slots: flow: path.b2xIdentityUserFlow-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages'].post update: x-apievangelist-phrasing: intent: Add a language to a user flow effect: write questions: - How do I add a new language configuration to a B2X user flow? - Can I add a language that starts disabled? instructions: - text: Add language {language} to user flow {flow}. slots: language: requestBody.id flow: path.b2xIdentityUserFlow-id - text: Add language {language} named {name} to flow {flow} with enabled set to {enabled}. slots: language: requestBody.id name: requestBody.displayName flow: path.b2xIdentityUserFlow-id enabled: requestBody.isEnabled method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}'].get update: x-apievangelist-phrasing: intent: Get a language configuration of a user flow effect: read questions: - Is a particular language enabled in my sign-up user flow? - What are the settings of one language configuration in a B2X flow? instructions: - text: Get language {language} of user flow {flow}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Show whether language {language} is enabled on flow {flow}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}'].delete update: x-apievangelist-phrasing: intent: Remove a language from a user flow effect: destructive questions: - How do I remove a language configuration from a guest sign-up flow? - Can I delete a language I no longer want to offer in a user flow? instructions: - text: Remove language {language} from user flow {flow}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Delete the {language} language configuration on flow {flow}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}'].patch update: x-apievangelist-phrasing: intent: Update a language configuration effect: write questions: - How do I enable or disable a language in an existing user flow? - Can I rename a language configuration in my sign-up flow? instructions: - text: Set enabled to {enabled} for language {language} in flow {flow}. slots: enabled: requestBody.isEnabled language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Rename language {language} on flow {flow} to {name}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id name: requestBody.displayName method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/defaultPages'].get update: x-apievangelist-phrasing: intent: List default pages for a user flow language effect: read questions: - What default text pages are shown to users for a language in my sign-up flow? - Can I see the out-of-the-box page content for one user flow language? instructions: - text: List the default pages for language {language} in flow {flow}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Show the first {top} default pages of language {language} on flow {flow}. slots: top: query.$top language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/defaultPages'].post update: x-apievangelist-phrasing: intent: Create a default page for a user flow language effect: write questions: - How do I add a new default page entry to a user flow language? - Can I create a default page record under a language configuration? instructions: - text: Create default page {page} under language {language} of flow {flow}. slots: page: requestBody.id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Add a new default page to the {language} language of user flow {flow}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/defaultPages/{userFlowLanguagePage-id}'].get update: x-apievangelist-phrasing: intent: Get one default page of a user flow language effect: read questions: - What does one specific default page look like for a language in my user flow? - Which properties does a single default language page record have? instructions: - text: Get default page {page} of language {language} in flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Show the default page record {page} for language {language} on flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/defaultPages/{userFlowLanguagePage-id}'].delete update: x-apievangelist-phrasing: intent: Delete a default page record effect: destructive questions: - How do I delete a default page entity from a user flow language? - Can a default language page record be removed entirely? instructions: - text: Delete default page {page} from language {language} of flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Remove the default page entity {page} under {language} in user flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/defaultPages/{userFlowLanguagePage-id}'].patch update: x-apievangelist-phrasing: intent: Update a default page record effect: write questions: - How do I update the properties of a default page entity in a user flow language? - Can I patch a default language page record itself rather than its content? instructions: - text: Update default page record {page} of language {language} in flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Patch the default page entity {page} under {language} on user flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/defaultPages/{userFlowLanguagePage-id}/$value'].get update: x-apievangelist-phrasing: intent: Download the content of a default page effect: read questions: - How do I read the actual values shown to users on a default language page? - Can I download the raw content file of a default user flow page? instructions: - text: Download the content of default page {page} for language {language} in flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Get the raw text values of default page {page} under {language} on flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/defaultPages/{userFlowLanguagePage-id}/$value'].put update: x-apievangelist-phrasing: intent: Replace the content of a default page effect: write questions: - How do I upload new media content for a default language page? - Can I overwrite the content file stored on a default user flow page? instructions: - text: Upload new content for default page {page} of language {language} in flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Replace the stored content of default page {page} under {language} on flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/defaultPages/{userFlowLanguagePage-id}/$value'].delete update: x-apievangelist-phrasing: intent: Delete the content of a default page effect: destructive questions: - How do I clear the media content stored on a default language page? - Can I delete just the content file of a default page but keep the page record? instructions: - text: Delete the content of default page {page} for language {language} in flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Clear the stored content file on default page {page} under {language}, flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/defaultPages/$count'].get update: x-apievangelist-phrasing: intent: Count default pages for a user flow language effect: read questions: - How many default pages exist for one language in my user flow? - What is the total of default pages under a language configuration? instructions: - text: Count the default pages of language {language} in flow {flow}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Give me the number of default pages under {language} on user flow {flow}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/overridesPages'].get update: x-apievangelist-phrasing: intent: List override pages for a user flow language effect: read questions: - Which customized override pages have I set for a language in my sign-up flow? - Can I see the pages where I override the default text for a user flow language? instructions: - text: List the override pages for language {language} in flow {flow}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Show override pages of {language} on flow {flow} matching {filter}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/overridesPages'].post update: x-apievangelist-phrasing: intent: Create an override page for a user flow language effect: write questions: - How do I add a new override page to customize text for a user flow language? - Can I create an overrides page record under a language configuration? instructions: - text: Create override page {page} under language {language} of flow {flow}. slots: page: requestBody.id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Add a new override page to the {language} language of user flow {flow}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/overridesPages/{userFlowLanguagePage-id}'].get update: x-apievangelist-phrasing: intent: Get one override page of a user flow language effect: read questions: - What does one specific override page contain for a language in my user flow? - Which properties does a single customized override page record have? instructions: - text: Get override page {page} of language {language} in flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Show the override page record {page} for language {language} on flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/overridesPages/{userFlowLanguagePage-id}'].delete update: x-apievangelist-phrasing: intent: Delete an override page effect: destructive questions: - How do I delete a customized override page from a user flow language? - Can I remove an override page record to fall back to the defaults? instructions: - text: Delete override page {page} from language {language} of flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Remove the override page entity {page} under {language} in user flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/overridesPages/{userFlowLanguagePage-id}'].patch update: x-apievangelist-phrasing: intent: Update an override page record effect: write questions: - How do I update the properties of an override page entity in a user flow language? - Can I patch an override page record itself rather than its content file? instructions: - text: Update override page record {page} of language {language} in flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Patch the override page entity {page} under {language} on user flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/overridesPages/{userFlowLanguagePage-id}/$value'].get update: x-apievangelist-phrasing: intent: Download the content of an override page effect: read questions: - How do I read the custom values I set on an override language page? - Can I download the raw content file of an override page? instructions: - text: Download the content of override page {page} for language {language} in flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Get the raw custom text of override page {page} under {language} on flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/overridesPages/{userFlowLanguagePage-id}/$value'].put update: x-apievangelist-phrasing: intent: Upload customized content for an override page effect: write questions: - How do I upload custom text to override what users see on a sign-up page? - Can I replace the content file of an override page with my own strings? instructions: - text: Upload custom content for override page {page} of language {language} in flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Replace the override text file on page {page} under {language}, user flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/overridesPages/{userFlowLanguagePage-id}/$value'].delete update: x-apievangelist-phrasing: intent: Delete the content of an override page effect: destructive questions: - How do I clear the custom values stored on an override language page? - Can I delete just the content of an override page but keep the page record? instructions: - text: Delete the content of override page {page} for language {language} in flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Clear the custom content file on override page {page} under {language}, flow {flow}. slots: page: path.userFlowLanguagePage-id language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/{userFlowLanguageConfiguration-id}/overridesPages/$count'].get update: x-apievangelist-phrasing: intent: Count override pages for a user flow language effect: read questions: - How many override pages have I customized for one language in my user flow? - What is the total of overrides pages under a language configuration? instructions: - text: Count the override pages of language {language} in flow {flow}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id - text: Give me the number of override pages under {language} on user flow {flow}. slots: language: path.userFlowLanguageConfiguration-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/languages/$count'].get update: x-apievangelist-phrasing: intent: Count languages in a user flow effect: read questions: - How many languages are configured on a B2X user flow? - What is the number of language configurations in one sign-up flow? instructions: - text: Count the languages configured on user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Give me the number of languages on flow {flow} matching {filter}. slots: flow: path.b2xIdentityUserFlow-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userAttributeAssignments'].get update: x-apievangelist-phrasing: intent: List attributes collected by a user flow effect: read questions: - Which user attributes does my B2X sign-up flow collect from guests? - What attribute assignments are configured on a self-service sign-up flow? instructions: - text: List the user attribute assignments in flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Show attributes collected by flow {flow} matching {filter}. slots: flow: path.b2xIdentityUserFlow-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userAttributeAssignments'].post update: x-apievangelist-phrasing: intent: Add a user attribute to a user flow effect: write questions: - How do I make my sign-up flow collect an extra attribute like job title? - Can I add an attribute as optional or require verification for it? instructions: - text: Add attribute {attribute} to user flow {flow} labeled {label}. slots: attribute: requestBody.userAttribute flow: path.b2xIdentityUserFlow-id label: requestBody.displayName - text: Collect attribute {attribute} in flow {flow} with input type {inputType}, optional {optional}. slots: attribute: requestBody.userAttribute flow: path.b2xIdentityUserFlow-id inputType: requestBody.userInputType optional: requestBody.isOptional method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userAttributeAssignments/{identityUserFlowAttributeAssignment-id}'].get update: x-apievangelist-phrasing: intent: Get one attribute assignment in a user flow effect: read questions: - Is a particular collected attribute optional in my sign-up flow? - What input type and label does one attribute assignment use? instructions: - text: Get attribute assignment {assignment} in user flow {flow}. slots: assignment: path.identityUserFlowAttributeAssignment-id flow: path.b2xIdentityUserFlow-id - text: Show the settings of attribute assignment {assignment} on flow {flow}. slots: assignment: path.identityUserFlowAttributeAssignment-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userAttributeAssignments/{identityUserFlowAttributeAssignment-id}'].delete update: x-apievangelist-phrasing: intent: Remove an attribute from a user flow effect: destructive questions: - How do I stop my sign-up flow from collecting a certain attribute? - Can I delete an attribute assignment from a B2X user flow? instructions: - text: Remove attribute assignment {assignment} from user flow {flow}. slots: assignment: path.identityUserFlowAttributeAssignment-id flow: path.b2xIdentityUserFlow-id - text: Delete attribute assignment {assignment} on sign-up flow {flow}. slots: assignment: path.identityUserFlowAttributeAssignment-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userAttributeAssignments/{identityUserFlowAttributeAssignment-id}'].patch update: x-apievangelist-phrasing: intent: Update an attribute assignment effect: write questions: - How do I make a collected attribute optional in an existing sign-up flow? - Can I change the label or input type of an attribute already in a user flow? instructions: - text: Set optional to {optional} for attribute assignment {assignment} in flow {flow}. slots: optional: requestBody.isOptional assignment: path.identityUserFlowAttributeAssignment-id flow: path.b2xIdentityUserFlow-id - text: Relabel attribute assignment {assignment} on flow {flow} as {label}. slots: assignment: path.identityUserFlowAttributeAssignment-id flow: path.b2xIdentityUserFlow-id label: requestBody.displayName method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userAttributeAssignments/{identityUserFlowAttributeAssignment-id}/userAttribute'].get update: x-apievangelist-phrasing: intent: Get the user attribute behind an assignment effect: read questions: - Which underlying user attribute does an attribute assignment point to? - What attribute definition is added to my user flow by a given assignment? instructions: - text: Get the user attribute for assignment {assignment} in flow {flow}. slots: assignment: path.identityUserFlowAttributeAssignment-id flow: path.b2xIdentityUserFlow-id - text: Show the attribute definition behind assignment {assignment} on flow {flow}. slots: assignment: path.identityUserFlowAttributeAssignment-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userAttributeAssignments/$count'].get update: x-apievangelist-phrasing: intent: Count attribute assignments in a user flow effect: read questions: - How many attributes does my sign-up user flow collect? - What is the number of attribute assignments on one B2X flow? instructions: - text: Count the attribute assignments in user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Give me the number of collected attributes on flow {flow} matching {filter}. slots: flow: path.b2xIdentityUserFlow-id filter: query.$filter method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userAttributeAssignments/microsoft.graph.getOrder()'].get update: x-apievangelist-phrasing: intent: Get the order attributes are collected in effect: read questions: - In what order are attributes shown to users during sign-up? - Can I see the current sequence of collected attributes in a user flow? instructions: - text: Get the attribute collection order for user flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Show the sequence in which flow {flow} asks for attributes. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userAttributeAssignments/microsoft.graph.setOrder'].post update: x-apievangelist-phrasing: intent: Reorder the attributes a user flow collects effect: write questions: - How do I change the order attributes appear on the sign-up page? - Can I move one collected attribute ahead of another in a user flow? instructions: - text: Set the attribute collection order for flow {flow} to {order}. slots: flow: path.b2xIdentityUserFlow-id order: requestBody.newAssignmentOrder - text: Reorder attributes on sign-up flow {flow} as {order}. slots: flow: path.b2xIdentityUserFlow-id order: requestBody.newAssignmentOrder method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userFlowIdentityProviders'].get update: x-apievangelist-phrasing: intent: List user flow identity providers effect: read questions: - Which identity provider base objects are attached to a user flow? - What are the full records of the userFlowIdentityProviders on a B2X flow? instructions: - text: List the userFlowIdentityProviders objects on flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Show the top {top} user flow identity provider records for flow {flow}. slots: top: query.$top flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userFlowIdentityProviders/{identityProviderBase-id}/$ref'].delete update: x-apievangelist-phrasing: intent: Detach one identity provider from a user flow effect: destructive questions: - How do I detach a specific identity provider from a user flow by its ID? - Can I unlink one sign-in provider from a sign-up flow without deleting the provider? instructions: - text: Detach identity provider {provider} from user flow {flow}. slots: provider: path.identityProviderBase-id flow: path.b2xIdentityUserFlow-id - text: Unlink provider {provider} (by path ID) from sign-up flow {flow}. slots: provider: path.identityProviderBase-id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userFlowIdentityProviders/$count'].get update: x-apievangelist-phrasing: intent: Count user flow identity providers effect: read questions: - How many userFlowIdentityProviders are linked to a user flow? - What is the count of identity provider base objects on one sign-up flow? instructions: - text: Count the userFlowIdentityProviders linked to flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Tell me how many user flow identity provider links flow {flow} has. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userFlowIdentityProviders/$ref'].get update: x-apievangelist-phrasing: intent: List references to user flow identity providers effect: read questions: - What reference links point to the identity providers on a user flow? - Can I get only the $ref IDs of the userFlowIdentityProviders? instructions: - text: List the $ref links of userFlowIdentityProviders on flow {flow}. slots: flow: path.b2xIdentityUserFlow-id - text: Show only the reference IDs of identity providers linked to flow {flow}. slots: flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userFlowIdentityProviders/$ref'].post update: x-apievangelist-phrasing: intent: Link an identity provider to a user flow effect: write questions: - How do I add an existing identity provider to a B2X sign-up flow? - Can I let guests sign in with another configured provider in my user flow? instructions: - text: Link identity provider {provider} to user flow {flow}. slots: provider: requestBody.@odata.id flow: path.b2xIdentityUserFlow-id - text: Add the existing provider reference {provider} to sign-up flow {flow}. slots: provider: requestBody.@odata.id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/{b2xIdentityUserFlow-id}/userFlowIdentityProviders/$ref'].delete update: x-apievangelist-phrasing: intent: Unlink an identity provider by reference effect: destructive questions: - How do I remove an identity provider link from a user flow using its @id reference? - Can I unlink a provider from a sign-up flow by passing its reference URL? instructions: - text: Unlink the identity provider with reference {ref} from user flow {flow}. slots: ref: query.@id flow: path.b2xIdentityUserFlow-id - text: Remove provider link {ref} from flow {flow} using the @id query. slots: ref: query.@id flow: path.b2xIdentityUserFlow-id method: generated generated: '2026-10-01' - target: $.paths['/identity/b2xUserFlows/$count'].get update: x-apievangelist-phrasing: intent: Count B2X user flows effect: read questions: - How many B2X self-service sign-up user flows exist in my tenant? - What is the total number of guest user flows configured? instructions: - text: Count the B2X user flows in the tenant. - text: Give me the number of B2X user flows matching {filter}. slots: filter: query.$filter method: generated generated: '2026-10-01'