# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure API Client Static Sites API
  version: 1.0.0
extends: openapi/microsoft-azure-static-sites-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: 75
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/locations/{location}/previewStaticSiteWorkflowFile'].post
  update:
    x-apievangelist-phrasing:
      intent: Preview a static site GitHub workflow file
      effect: read
      questions:
      - Can I see what the generated deployment workflow file will look like before creating a static web app?
      - Is there a way to preview the build workflow YAML for a static site in a given Azure region?
      instructions:
      - text: Generate a preview of the static site workflow file for region {location} in subscription {subscription}.
        slots:
          location: path.location
          subscription: path.subscriptionId
      - text: Show me the workflow file a new static web app in {location} would get, without creating anything.
        slots:
          location: path.location
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/staticSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List all static web apps in a subscription
      effect: read
      questions:
      - Which static web apps exist across my whole Azure subscription?
      - How do I get every Azure Static Web App I own regardless of resource group?
      instructions:
      - text: List every static site in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show all static web apps across all resource groups.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List static web apps in a resource group
      effect: read
      questions:
      - What static web apps are deployed in one particular resource group?
      - Can I list only the static sites that belong to a single resource group?
      instructions:
      - text: List the static sites in resource group {resource_group} of subscription {subscription}.
        slots:
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show which static web apps live in {resource_group}.
        slots:
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of a static web app
      effect: read
      questions:
      - How can I look up the configuration and hostname of one static web app?
      - What SKU and settings does a specific static site currently have?
      instructions:
      - text: Get the details of static site {site} in resource group {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show me the properties of static web app {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a static web app
      effect: write
      questions:
      - How do I create a new Azure Static Web App in an existing resource group?
      - Can I set the SKU and managed identity when provisioning a static site?
      instructions:
      - text: Create static site {site} in resource group {resource_group} of subscription {subscription} with the {sku} SKU.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          sku: requestBody.sku
          subscription: path.subscriptionId
      - text: Provision a new static web app named {site} in {resource_group} with a managed identity {identity}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          identity: requestBody.identity
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a static web app
      effect: destructive
      questions:
      - How do I permanently remove a static web app I no longer need?
      - What happens to a static site when I delete the whole resource?
      instructions:
      - text: Delete static site {site} from resource group {resource_group} in subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Tear down the static web app {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch properties of an existing static web app
      effect: write
      questions:
      - Can I change just a few properties of a static site without redefining the whole resource?
      - Is there a partial update for an existing static web app's settings?
      instructions:
      - text: Patch the existing static site {site} in {resource_group} of subscription {subscription} with properties {properties}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          properties: requestBody.properties
          subscription: path.subscriptionId
      - text: Apply a partial update to static web app {site} that I already created.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/authproviders/{authprovider}/listUsers'].post
  update:
    x-apievangelist-phrasing:
      intent: List users of a static web app by auth provider
      effect: read
      questions:
      - Who are the invited users of my static web app for a given authentication provider?
      - Can I see which people signed in to a static site through one identity provider?
      instructions:
      - text: List users of static site {site} in {resource_group} of subscription {subscription} for auth provider {auth_provider}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          auth_provider: path.authprovider
          subscription: path.subscriptionId
      - text: Show everyone registered on {site} through the {auth_provider} provider.
        slots:
          site: path.name
          auth_provider: path.authprovider
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/authproviders/{authprovider}/users/{userid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a user from a static web app
      effect: destructive
      questions:
      - How do I revoke a person's access to my static web app?
      - Can I delete a single user entry from a static site's auth provider?
      instructions:
      - text: Remove user {user_id} from static site {site} in {resource_group} of subscription {subscription} under auth provider {auth_provider}.
        slots:
          user_id: path.userid
          site: path.name
          resource_group: path.resourceGroupName
          auth_provider: path.authprovider
          subscription: path.subscriptionId
      - text: Delete user entry {user_id} from {site}.
        slots:
          user_id: path.userid
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/authproviders/{authprovider}/users/{userid}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change the roles of a static web app user
      effect: write
      questions:
      - How can I give an existing static site user a different role?
      - Can I update which roles a user holds on my static web app?
      instructions:
      - text: Update roles for user {user_id} on static site {site} in {resource_group} of subscription {subscription} via auth provider {auth_provider}.
        slots:
          user_id: path.userid
          site: path.name
          resource_group: path.resourceGroupName
          auth_provider: path.authprovider
          subscription: path.subscriptionId
      - text: Set the roles of user {user_id} on {site} to {properties}.
        slots:
          user_id: path.userid
          site: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List builds and environments of a static web app
      effect: read
      questions:
      - What preview environments and builds exist for my static site?
      - Can I list all the builds that have been produced for one static web app?
      instructions:
      - text: List all builds for static site {site} in {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the environments deployed for {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one static web app build environment
      effect: read
      questions:
      - How do I check the status of a particular pull request environment on my static site?
      - What are the details of a single build of a static web app?
      instructions:
      - text: Get build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the details of the {environment} environment on {site}.
        slots:
          environment: path.environmentName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a static web app build environment
      effect: destructive
      questions:
      - Can I remove a stale preview environment from my static site?
      - How do I delete one build of a static web app without deleting the app?
      instructions:
      - text: Delete build {environment} from static site {site} in {resource_group} of subscription {subscription}.
        slots:
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove the {environment} preview environment of {site}.
        slots:
          environment: path.environmentName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/config/appsettings'].put
  update:
    x-apievangelist-phrasing:
      intent: Set app settings for a static site build
      effect: write
      questions:
      - Can I give a single preview environment its own app settings?
      - How do I write environment variables for one build of my static site?
      instructions:
      - text: Replace the app settings of build {environment} on static site {site} in {resource_group} of subscription {subscription}.
        slots:
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Write new app settings to the {environment} build of {site}.
        slots:
          environment: path.environmentName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/config/functionappsettings'].put
  update:
    x-apievangelist-phrasing:
      intent: Set function app settings for a static site build
      effect: write
      questions:
      - Can the managed functions in one preview environment get their own settings?
      - Where do I write function app settings for a single static site build?
      instructions:
      - text: Overwrite what the managed functions in preview build {environment} of {site} ({resource_group}, subscription {subscription}) see as settings.
        slots:
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Write function app settings for the {environment} build of {site}.
        slots:
          environment: path.environmentName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/databaseConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List database connections of a static site build
      effect: read
      questions:
      - Which databases are connected to one preview environment of my static site?
      - Can I get an overview of database connections for a single build?
      instructions:
      - text: List database connection overviews for build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show which databases the {environment} build of {site} connects to.
        slots:
          environment: path.environmentName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/databaseConnections/{databaseConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a database connection of a static site build
      effect: read
      questions:
      - How do I look up one named database connection on a preview build?
      - What's the overview of a specific database connection in a static site environment?
      instructions:
      - text: Get database connection {connection} on build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.databaseConnectionName
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the overview of connection {connection} in the {environment} build.
        slots:
          connection: path.databaseConnectionName
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/databaseConnections/{databaseConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a database connection for a static site build
      effect: write
      questions:
      - Can I attach a database to just one preview environment of my static site?
      - How do I define a new database connection on a static site build?
      instructions:
      - text: Create database connection {connection} on build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.databaseConnectionName
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Put a full database connection {connection} with properties {properties} on the {environment} build.
        slots:
          connection: path.databaseConnectionName
          properties: requestBody.properties
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/databaseConnections/{databaseConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a database connection from a static site build
      effect: destructive
      questions:
      - How do I detach a database from a single preview environment?
      - Can I remove one database connection from a build without touching production?
      instructions:
      - text: Delete database connection {connection} from build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.databaseConnectionName
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove connection {connection} from the {environment} build.
        slots:
          connection: path.databaseConnectionName
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/databaseConnections/{databaseConnectionName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a database connection on a static site build
      effect: write
      questions:
      - Can I change a few fields of an existing database connection on a preview build?
      - Is there a partial update for a build's database connection?
      instructions:
      - text: Patch existing database connection {connection} on build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.databaseConnectionName
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Partially update build connection {connection} in {environment} with {properties}.
        slots:
          connection: path.databaseConnectionName
          environment: path.environmentName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/databaseConnections/{databaseConnectionName}/show'].post
  update:
    x-apievangelist-phrasing:
      intent: Show full details of a build database connection
      effect: read
      questions:
      - How can I see the full details, not just the overview, of a build's database connection?
      - What complete configuration does a named database connection on a preview build have?
      instructions:
      - text: Show full details of database connection {connection} on build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.databaseConnectionName
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Reveal the detailed configuration of build connection {connection} in {environment}.
        slots:
          connection: path.databaseConnectionName
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/functions'].get
  update:
    x-apievangelist-phrasing:
      intent: List functions of a static site build
      effect: read
      questions:
      - Which API functions are deployed with a particular preview build?
      - Can I list the functions that one environment of my static site exposes?
      instructions:
      - text: List the functions in build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the functions deployed to the {environment} build of {site}.
        slots:
          environment: path.environmentName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/listAppSettings'].post
  update:
    x-apievangelist-phrasing:
      intent: Read app settings of a static site build
      effect: read
      questions:
      - What application settings is a specific preview build currently using?
      - Can I read back the app settings of one static site environment?
      instructions:
      - text: Read the app settings of build {environment} on static site {site} in {resource_group} of subscription {subscription}.
        slots:
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the current app settings for the {environment} build of {site}.
        slots:
          environment: path.environmentName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/listFunctionAppSettings'].post
  update:
    x-apievangelist-phrasing:
      intent: Read function app settings of a static site build
      effect: read
      questions:
      - What function app settings are applied to a particular preview build?
      - Can I read the settings the functions in one build are running with?
      instructions:
      - text: Fetch the settings that functions in build {environment} of {site} ({resource_group}, subscription {subscription}) run with.
        slots:
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the current function app settings for the {environment} build.
        slots:
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/showDatabaseConnections'].post
  update:
    x-apievangelist-phrasing:
      intent: Show full details of all build database connections
      effect: read
      questions:
      - Can I get the detailed configuration of every database connection on a preview build at once?
      - Where do I see complete details, not overviews, for all of a build's database connections?
      instructions:
      - text: Show detailed info for all database connections on build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Reveal every database connection's full configuration in the {environment} build.
        slots:
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/userProvidedFunctionApps'].get
  update:
    x-apievangelist-phrasing:
      intent: List bring-your-own function apps on a site build
      effect: read
      questions:
      - Which of my own function apps are registered with a particular preview build?
      - Can I see the user-provided function apps linked to one static site environment?
      instructions:
      - text: List user-provided function apps registered with build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the bring-your-own function apps on the {environment} build.
        slots:
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/userProvidedFunctionApps/{functionAppName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a bring-your-own function app on a site build
      effect: read
      questions:
      - How do I look up one user-provided function app registered to a preview build?
      - What are the details of a specific function app I linked to a static site environment?
      instructions:
      - text: Get function app {function_app} registered with build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          function_app: path.functionAppName
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the registration of function app {function_app} on the {environment} build.
        slots:
          function_app: path.functionAppName
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/userProvidedFunctionApps/{functionAppName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Register your own function app with a site build
      effect: write
      questions:
      - Can I use my existing function app as the backend for a single preview build?
      - Is it possible to force-register a function app to a build even if one is already linked?
      instructions:
      - text: Register function app {function_app} with build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          function_app: path.functionAppName
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Force-register {function_app} to the {environment} build, setting isForced to {is_forced}.
        slots:
          function_app: path.functionAppName
          environment: path.environmentName
          is_forced: query.isForced
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/userProvidedFunctionApps/{functionAppName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Detach your own function app from a site build
      effect: destructive
      questions:
      - How do I unlink a user-provided function app from one preview build?
      - Can I detach my function app from a single environment but keep it on production?
      instructions:
      - text: Detach function app {function_app} from build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          function_app: path.functionAppName
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Unlink {function_app} from the {environment} build.
        slots:
          function_app: path.functionAppName
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/zipdeploy'].post
  update:
    x-apievangelist-phrasing:
      intent: Deploy a zip package to a static site environment
      effect: write
      questions:
      - Can I push zipped content straight to one specific environment of my static site?
      - Is there a zip deploy option that targets a preview environment instead of production?
      instructions:
      - text: Zip-deploy content to environment {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Deploy the zip package {properties} to the {environment} environment.
        slots:
          properties: requestBody.properties
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/config/appsettings'].put
  update:
    x-apievangelist-phrasing:
      intent: Set app settings for a static web app
      effect: write
      questions:
      - How do I set site-wide environment variables for my static web app?
      - Can I replace the app settings on a static site as a whole, not per build?
      instructions:
      - text: Replace the site-level app settings of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Write new app settings for the whole of {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/basicAuth'].get
  update:
    x-apievangelist-phrasing:
      intent: List basic auth settings of a static web app
      effect: read
      questions:
      - Is password protection turned on for my static site?
      - Can I list all the basic auth configurations on a static web app?
      instructions:
      - text: List the basic auth settings of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show every basic auth configuration on {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/basicAuth/{basicAuthName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one basic auth configuration of a static site
      effect: read
      questions:
      - What does a specific named basic auth configuration on my static site contain?
      - Which environments does one basic auth setting protect?
      instructions:
      - text: Get basic auth configuration {basic_auth} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          basic_auth: path.basicAuthName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the {basic_auth} basic auth entry on {site}.
        slots:
          basic_auth: path.basicAuthName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/basicAuth/{basicAuthName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or change password protection on a static site
      effect: write
      questions:
      - How do I password-protect my static web app with basic auth?
      - Can I change the basic auth password on a static site?
      instructions:
      - text: Enable basic auth {basic_auth} on static site {site} in {resource_group} of subscription {subscription}.
        slots:
          basic_auth: path.basicAuthName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Set basic auth {basic_auth} on {site} to {properties}.
        slots:
          basic_auth: path.basicAuthName
          site: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/config/functionappsettings'].put
  update:
    x-apievangelist-phrasing:
      intent: Set function app settings for a static web app
      effect: write
      questions:
      - Where do I set site-wide settings for the managed functions behind my static web app?
      - Can I replace the function app settings for a whole static site rather than one build?
      instructions:
      - text: Overwrite the managed-function settings for every environment of {site} in {resource_group}, subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Write function app settings for the whole of {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/createUserInvitation'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a role invitation link for a static site
      effect: write
      questions:
      - How do I invite someone to my static web app with a specific role?
      - Can I generate an invitation link that grants a role on a static site?
      instructions:
      - text: Create an invitation link for static site {site} in {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Invite a user to {site} with the invitation details {properties}.
        slots:
          site: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/customDomains'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom domains of a static web app
      effect: read
      questions:
      - Which custom domains are attached to my static web app?
      - Can I see every hostname I've mapped to a static site?
      instructions:
      - text: List the custom domains of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show all custom hostnames mapped to {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/customDomains/{domainName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom domain on a static web app
      effect: read
      questions:
      - What's the validation status of one custom domain on my static site?
      - How can I look up a single custom domain attached to a static web app?
      instructions:
      - text: Get custom domain {domain} on static site {site} in {resource_group} of subscription {subscription}.
        slots:
          domain: path.domainName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the status of {domain} on {site}.
        slots:
          domain: path.domainName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/customDomains/{domainName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a custom domain to a static web app
      effect: write
      questions:
      - How do I point my own domain at a static web app?
      - Can I attach a custom hostname to an existing static site?
      instructions:
      - text: Add custom domain {domain} to static site {site} in {resource_group} of subscription {subscription}.
        slots:
          domain: path.domainName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Attach {domain} to {site} using validation settings {properties}.
        slots:
          domain: path.domainName
          site: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/customDomains/{domainName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a custom domain from a static web app
      effect: destructive
      questions:
      - How do I stop serving my static site on a custom domain?
      - Can I detach one custom hostname from a static web app?
      instructions:
      - text: Remove custom domain {domain} from static site {site} in {resource_group} of subscription {subscription}.
        slots:
          domain: path.domainName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Delete the {domain} mapping from {site}.
        slots:
          domain: path.domainName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/customDomains/{domainName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a custom domain can be added to a static site
      effect: read
      questions:
      - Before attaching a domain, can I check whether it will be accepted by my static site?
      - Is there a dry-run validation for adding a custom domain to a static web app?
      instructions:
      - text: Validate that {domain} can be added to static site {site} in {resource_group} of subscription {subscription}.
        slots:
          domain: path.domainName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Check whether custom domain {domain} is eligible for {site}.
        slots:
          domain: path.domainName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/databaseConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List database connections of a static web app
      effect: read
      questions:
      - Which databases is my static web app connected to at the site level?
      - Can I get an overview of all database connections on a static site?
      instructions:
      - text: Give me an overview of every database wired to {site} at site level ({resource_group}, subscription {subscription}).
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the site-level databases connected to {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/databaseConnections/{databaseConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a database connection of a static web app
      effect: read
      questions:
      - How do I view the overview of one named database connection on my static site?
      - What database does a specific site-level connection point to?
      instructions:
      - text: Get site-level database connection {connection} on static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.databaseConnectionName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the overview of site connection {connection} on {site}.
        slots:
          connection: path.databaseConnectionName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/databaseConnections/{databaseConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a database connection for a static web app
      effect: write
      questions:
      - How do I connect a database to my static web app for every environment?
      - Can I define a new site-level database connection on a static site?
      instructions:
      - text: Create site-level database connection {connection} on static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.databaseConnectionName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Put a full site database connection {connection} on {site} with {properties}.
        slots:
          connection: path.databaseConnectionName
          site: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/databaseConnections/{databaseConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a database connection from a static web app
      effect: destructive
      questions:
      - How do I disconnect a database from my static site entirely?
      - Can I remove a site-level database connection from a static web app?
      instructions:
      - text: Delete site-level database connection {connection} from static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.databaseConnectionName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove site connection {connection} from {site}.
        slots:
          connection: path.databaseConnectionName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/databaseConnections/{databaseConnectionName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a database connection on a static web app
      effect: write
      questions:
      - Can I tweak one field of an existing site-level database connection?
      - Is there a partial update for a static site's database connection?
      instructions:
      - text: Patch existing site-level database connection {connection} on static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.databaseConnectionName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Partially update site connection {connection} on {site} with {properties}.
        slots:
          connection: path.databaseConnectionName
          site: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/databaseConnections/{databaseConnectionName}/show'].post
  update:
    x-apievangelist-phrasing:
      intent: Show full details of a site database connection
      effect: read
      questions:
      - How can I see the complete configuration of one site-level database connection?
      - What full details does a named database connection on my static site hold?
      instructions:
      - text: Show full details of site-level database connection {connection} on static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.databaseConnectionName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Reveal the detailed configuration of site connection {connection} on {site}.
        slots:
          connection: path.databaseConnectionName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/detach'].post
  update:
    x-apievangelist-phrasing:
      intent: Detach a static web app
      effect: destructive
      questions:
      - Can I detach a static site from its source setup without deleting it?
      - Is there an operation to detach a static web app?
      instructions:
      - text: Detach static site {site} in resource group {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Run the detach action on static web app {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/functions'].get
  update:
    x-apievangelist-phrasing:
      intent: List functions of a static web app
      effect: read
      questions:
      - Which API functions does my static web app expose in production?
      - Can I list the functions of a static site as a whole?
      instructions:
      - text: Show which API functions the production site {site} in {resource_group}, subscription {subscription}, exposes.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the site-level functions deployed with {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/listAppSettings'].post
  update:
    x-apievangelist-phrasing:
      intent: Read app settings of a static web app
      effect: read
      questions:
      - What environment variables is my static web app using at the site level?
      - Can I read back the site-wide application settings of a static site?
      instructions:
      - text: Read the site-level app settings of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the current app settings for the whole of {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/listConfiguredRoles'].post
  update:
    x-apievangelist-phrasing:
      intent: List roles configured for a static web app
      effect: read
      questions:
      - Which custom roles are defined on my static site?
      - Can I see the list of roles I can assign to users of a static web app?
      instructions:
      - text: List the configured roles of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the roles available on {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/listFunctionAppSettings'].post
  update:
    x-apievangelist-phrasing:
      intent: Read function app settings of a static web app
      effect: read
      questions:
      - What settings are the site-level managed functions of my static web app running with?
      - Can I read the function app settings for a whole static site?
      instructions:
      - text: Fetch what the site-wide managed functions of {site} in {resource_group}, subscription {subscription}, are configured with.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Tell me which settings the functions behind {site} are using.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/listSecrets'].post
  update:
    x-apievangelist-phrasing:
      intent: List secrets of a static web app
      effect: read
      questions:
      - Where can I get the deployment secrets for an existing static site?
      - Can I retrieve the secrets of my static web app?
      instructions:
      - text: List the secrets of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Fetch the secrets for {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/privateEndpointConnections'].get
  update:
    x-apievangelist-phrasing:
      intent: List private endpoint connections of a static site
      effect: read
      questions:
      - Which private endpoints are connected to my static web app?
      - Can I list all private endpoint connections associated with a static site?
      instructions:
      - text: List private endpoint connections for static site {site} in {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show every private endpoint linked to {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/privateEndpointConnections/{privateEndpointConnectionName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a private endpoint connection of a static site
      effect: read
      questions:
      - Is a particular private endpoint connection to my static site approved or pending?
      - How do I look up a single private endpoint connection on a static web app?
      instructions:
      - text: Get private endpoint connection {connection} on static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.privateEndpointConnectionName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the approval state of private endpoint connection {connection}.
        slots:
          connection: path.privateEndpointConnectionName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/privateEndpointConnections/{privateEndpointConnectionName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve or reject a private endpoint connection
      effect: write
      questions:
      - How do I approve a pending private endpoint request to my static site?
      - Can I reject a private endpoint connection someone requested on my static web app?
      instructions:
      - text: Approve private endpoint connection {connection} on static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.privateEndpointConnectionName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Reject the private endpoint request {connection} on {site}.
        slots:
          connection: path.privateEndpointConnectionName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/privateEndpointConnections/{privateEndpointConnectionName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a private endpoint connection from a static site
      effect: destructive
      questions:
      - Can I remove a private endpoint connection from my static web app entirely?
      - What's the way to delete a private endpoint link on a static site?
      instructions:
      - text: Delete private endpoint connection {connection} from static site {site} in {resource_group} of subscription {subscription}.
        slots:
          connection: path.privateEndpointConnectionName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove the private endpoint {connection} from {site}.
        slots:
          connection: path.privateEndpointConnectionName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/privateLinkResources'].get
  update:
    x-apievangelist-phrasing:
      intent: List private link resources of a static site
      effect: read
      questions:
      - What private link resources can a private endpoint target on my static web app?
      - Which group IDs are available for private linking to a static site?
      instructions:
      - text: List private link resources for static site {site} in {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the private link targets that {site} supports.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/resetapikey'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset the deployment API key of a static site
      effect: destructive
      questions:
      - How do I rotate the deployment token for my static web app if it leaked?
      - Can I reset the API key of an existing static site?
      instructions:
      - text: Reset the API key of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Rotate the deployment token for {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/showDatabaseConnections'].post
  update:
    x-apievangelist-phrasing:
      intent: Show full details of all site database connections
      effect: read
      questions:
      - Can I get the complete configuration of every site-level database connection at once?
      - Where do I see full details, not overviews, of all databases linked to my static site?
      instructions:
      - text: Show detailed info for all site-level database connections of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Reveal the full configuration of every database connected to {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/userProvidedFunctionApps'].get
  update:
    x-apievangelist-phrasing:
      intent: List bring-your-own function apps on a static site
      effect: read
      questions:
      - Which of my own function apps are registered with my static web app at the site level?
      - Can I see all user-provided function apps linked to a static site?
      instructions:
      - text: List the bring-your-own function apps wired site-wide to {site} in {resource_group}, subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the site-level bring-your-own function apps on {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/userProvidedFunctionApps/{functionAppName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a bring-your-own function app on a static site
      effect: read
      questions:
      - How do I check the site-level registration of one function app on my static web app?
      - What are the details of a specific user-provided function app on a static site?
      instructions:
      - text: Look up the site-wide registration of my own function app {function_app} on {site} ({resource_group}, subscription {subscription}).
        slots:
          function_app: path.functionAppName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the site-level registration of {function_app} on {site}.
        slots:
          function_app: path.functionAppName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/userProvidedFunctionApps/{functionAppName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Register your own function app with a static site
      effect: write
      questions:
      - Can I use an existing function app as the API backend for my whole static web app?
      - Is there a way to force a function app registration on a static site that already has one?
      instructions:
      - text: Use my existing function app {function_app} as the API for all of {site} in {resource_group}, subscription {subscription}.
        slots:
          function_app: path.functionAppName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Force-register {function_app} at the site level of {site} with isForced {is_forced}.
        slots:
          function_app: path.functionAppName
          site: path.name
          is_forced: query.isForced
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/userProvidedFunctionApps/{functionAppName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Detach your own function app from a static site
      effect: destructive
      questions:
      - How do I unlink my function app from a static web app at the site level?
      - Can I stop using a bring-your-own function app on my static site?
      instructions:
      - text: Stop using {function_app} as the site-wide API of {site} ({resource_group}, subscription {subscription}).
        slots:
          function_app: path.functionAppName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Unlink {function_app} from the whole of {site}.
        slots:
          function_app: path.functionAppName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/zipdeploy'].post
  update:
    x-apievangelist-phrasing:
      intent: Deploy a zip package to a static web app
      effect: write
      questions:
      - Can I deploy my static site by uploading a zip instead of using a CI workflow?
      - What's the way to push zipped content to a static web app's default environment?
      instructions:
      - text: Upload a zip and publish it as the main content of {site} in {resource_group}, subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Deploy the zip package {properties} to {site}.
        slots:
          properties: requestBody.properties
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/linkedBackends/{linkedBackendName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a backend can be linked to a static site
      effect: read
      questions:
      - Before linking an API backend to my static web app, can I check it will work?
      - Is there a validation step for linking a backend at the site level?
      instructions:
      - text: Before linking, test whether {backend} works as the site-wide backend for {site} ({resource_group}, subscription {subscription}).
        slots:
          backend: path.linkedBackendName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Check whether {backend} is linkable to {site} with settings {properties}.
        slots:
          backend: path.linkedBackendName
          site: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/linkedBackends/{linkedBackendName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a backend can be linked to a site build
      effect: read
      questions:
      - Can I test whether a backend is linkable to one preview environment before linking it?
      - Is there a validation check for linking a backend to a specific static site build?
      instructions:
      - text: Validate that backend {backend} can be linked to build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          backend: path.linkedBackendName
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Check whether {backend} is linkable to the {environment} build.
        slots:
          backend: path.linkedBackendName
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/linkedBackends'].get
  update:
    x-apievangelist-phrasing:
      intent: List backends linked to a static web app
      effect: read
      questions:
      - Which API backends are linked to my static web app at the site level?
      - Can I see every linked backend on a static site?
      instructions:
      - text: Show every site-wide backend attached to {site} in {resource_group}, subscription {subscription}.
        slots:
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the site-level linked backends of {site}.
        slots:
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/linkedBackends'].get
  update:
    x-apievangelist-phrasing:
      intent: List backends linked to a static site build
      effect: read
      questions:
      - What backends does one preview environment of my static site talk to?
      - Can I list the linked backends for a single build?
      instructions:
      - text: List the backends linked to build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the linked backends of the {environment} build.
        slots:
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/linkedBackends/{linkedBackendName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a backend linked to a static web app
      effect: read
      questions:
      - How do I view the details of one named backend linked to my static site?
      - Which resource does a specific site-level linked backend point to?
      instructions:
      - text: Look up site-wide backend link {backend} for {site} ({resource_group}, subscription {subscription}).
        slots:
          backend: path.linkedBackendName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the site-level linked backend {backend} on {site}.
        slots:
          backend: path.linkedBackendName
          site: path.name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/linkedBackends/{linkedBackendName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Link a backend to a static web app
      effect: write
      questions:
      - How do I connect an existing API or container app as the backend of my static web app?
      - Can I link a backend to a static site for all environments?
      instructions:
      - text: Connect {backend} as the backend for all environments of {site} in {resource_group}, subscription {subscription}.
        slots:
          backend: path.linkedBackendName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Attach backend {backend} at the site level of {site} using {properties}.
        slots:
          backend: path.linkedBackendName
          site: path.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/linkedBackends/{linkedBackendName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink a backend from a static web app
      effect: destructive
      questions:
      - How do I disconnect a linked backend from my static site?
      - Can I also clean up the backend's auth config when unlinking it from a static web app?
      instructions:
      - text: Disconnect site-wide backend {backend} from {site} in {resource_group}, subscription {subscription}.
        slots:
          backend: path.linkedBackendName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Unlink {backend} from {site} and set isCleaningAuthConfig to {clean_auth}.
        slots:
          backend: path.linkedBackendName
          site: path.name
          clean_auth: query.isCleaningAuthConfig
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/linkedBackends/{linkedBackendName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a backend linked to a static site build
      effect: read
      questions:
      - How can I inspect one linked backend on a specific preview build?
      - Which resource does a named backend on a static site build point to?
      instructions:
      - text: Get linked backend {backend} on build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          backend: path.linkedBackendName
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show backend {backend} as linked to the {environment} build.
        slots:
          backend: path.linkedBackendName
          environment: path.environmentName
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/linkedBackends/{linkedBackendName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Link a backend to a static site build
      effect: write
      questions:
      - Can I point one preview environment at a different backend than production?
      - How would I link a backend only to a specific static site build?
      instructions:
      - text: Link backend {backend} to build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          backend: path.linkedBackendName
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Attach {backend} to the {environment} build using {properties}.
        slots:
          backend: path.linkedBackendName
          environment: path.environmentName
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/linkedBackends/{linkedBackendName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unlink a backend from a static site build
      effect: destructive
      questions:
      - How do I disconnect a backend from just one preview build?
      - Can I clean up auth config while unlinking a backend from a single build?
      instructions:
      - text: Unlink backend {backend} from build {environment} of static site {site} in {resource_group} of subscription {subscription}.
        slots:
          backend: path.linkedBackendName
          environment: path.environmentName
          site: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Unlink {backend} from the {environment} build with isCleaningAuthConfig {clean_auth}.
        slots:
          backend: path.linkedBackendName
          environment: path.environmentName
          clean_auth: query.isCleaningAuthConfig
      method: generated
      generated: '2026-10-01'