# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WebApps API Client Static Sites API
  version: 1.0.0
extends: openapi/microsoft-azure-functions-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 the generated workflow file for a static site
      effect: read
      questions:
      - Can I see what build workflow file Azure would generate for my static site before I create it?
      - What does the generated deployment workflow YAML look like for a static web app in a given region?
      instructions:
      - text: Generate a preview of the static site workflow file for region {location}.
        slots:
          location: path.location
      - text: 'Show me the preview workflow file Azure would write for a static site with these properties: {properties}.'
        slots:
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Web/staticSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List all static sites in a subscription
      effect: read
      questions:
      - Which static web apps exist across my whole Azure subscription?
      - Can I get every Static Web App in my subscription regardless of resource group?
      instructions:
      - text: List every static site in my subscription.
      - text: Give me an inventory of all Azure Static Web Apps I own subscription-wide.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List static sites in a resource group
      effect: read
      questions:
      - What static web apps are deployed in one particular resource group?
      - Can I narrow my static site list down to a single resource group?
      instructions:
      - text: List the static sites in my current resource group.
      - text: Show only the static web apps that live in this resource group, not the whole subscription.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the details of a static site
      effect: read
      questions:
      - What are the settings, SKU and default hostname of one of my static web apps?
      - Can I look up a single static site's configuration by its name?
      instructions:
      - text: Get the details of static site {name}.
        slots:
          name: path.name
      - text: Show me the SKU and properties of the static web app called {name}.
        slots:
          name: 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 site
      effect: write
      questions:
      - How do I create a new Azure Static Web App in an existing resource group?
      - Can I choose the SKU and managed identity when I provision a static site?
      instructions:
      - text: Create a static site named {name} on the {sku} SKU.
        slots:
          name: path.name
          sku: requestBody.sku
      - text: Provision or fully redefine static web app {name} with identity {identity}.
        slots:
          name: path.name
          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 site
      effect: destructive
      questions:
      - Can I permanently remove a static web app I no longer need?
      - What happens when I tear down an entire Azure Static Web App resource?
      instructions:
      - text: Delete static site {name}.
        slots:
          name: path.name
      - text: Tear down the whole static web app {name} and its resource.
        slots:
          name: 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 site
      effect: write
      questions:
      - Can I change just a few properties of a static web app without resending the whole definition?
      - Is there a partial-update call for an existing static site?
      instructions:
      - text: 'Patch static site {name} with these property changes: {properties}.'
        slots:
          name: path.name
          properties: requestBody.properties
      - text: Apply a partial update to the existing static web app {name}.
        slots:
          name: 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 for a static site
      effect: read
      questions:
      - Is password protection turned on for my static web app?
      - Which basic auth configurations are set on a static site?
      instructions:
      - text: List the basic auth settings on static site {name}.
        slots:
          name: path.name
      - text: Show all password-protection configurations for static web app {name}.
        slots:
          name: 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:
      - Can I read a specific named basic auth configuration on my static site?
      - What environments does a particular basic auth entry protect on a static web app?
      instructions:
      - text: Get basic auth configuration {basicAuthName} for static site {name}.
        slots:
          basicAuthName: path.basicAuthName
          name: path.name
      - text: Show the {basicAuthName} password-protection entry on static web app {name}.
        slots:
          basicAuthName: path.basicAuthName
          name: 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 update basic auth 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 an existing static site?
      instructions:
      - text: 'Set basic auth {basicAuthName} on static site {name} with these properties: {properties}.'
        slots:
          basicAuthName: path.basicAuthName
          name: path.name
          properties: requestBody.properties
      - text: Turn on password protection for static web app {name}.
        slots:
          name: path.name
      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 of a static site
      effect: read
      questions:
      - Which builds and preview environments exist for my static web app?
      - Can I see every build environment, including pull request previews, for a static site?
      instructions:
      - text: List all builds for static site {name}.
        slots:
          name: path.name
      - text: Show the build environments of static web app {name}.
        slots:
          name: 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 a static site build
      effect: read
      questions:
      - What is the status and hostname of one specific build environment of my static site?
      - Can I look up a single preview environment build by its name?
      instructions:
      - text: Get build {environmentName} of static site {name}.
        slots:
          environmentName: path.environmentName
          name: path.name
      - text: Show the details of the {environmentName} environment build on static web app {name}.
        slots:
          environmentName: path.environmentName
          name: 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 site build environment
      effect: destructive
      questions:
      - Can I remove an old preview environment from my static web app without deleting the site?
      - What's the way to clean up a stale pull request build on a static site?
      instructions:
      - text: Delete build environment {environmentName} from static site {name}.
        slots:
          environmentName: path.environmentName
          name: path.name
      - text: Remove the {environmentName} preview build of static web app {name}.
        slots:
          environmentName: path.environmentName
          name: 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 on a static site build
      effect: write
      questions:
      - Can I give one preview environment its own app settings, separate from the production site?
      - How do I set environment variables on a single static site build?
      instructions:
      - text: Set app settings {properties} on build {environmentName} of static site {name}.
        slots:
          properties: requestBody.properties
          environmentName: path.environmentName
          name: path.name
      - text: Replace the build-level app settings for environment {environmentName} on static web app {name}.
        slots:
          environmentName: path.environmentName
          name: 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 on a static site build
      effect: write
      questions:
      - Can I configure settings for the managed functions of just one static site build environment?
      - Where do I set API function settings for a preview build of my static web app?
      instructions:
      - text: Configure the managed functions of build {environmentName} on static site {name} with settings {properties}.
        slots:
          properties: requestBody.properties
          environmentName: path.environmentName
          name: path.name
      - text: Update the build-level function settings for environment {environmentName} of static web app {name}.
        slots:
          environmentName: path.environmentName
          name: 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 for a static site build
      effect: read
      questions:
      - Which databases are connected to one build environment of my static web app?
      - Can I get an overview of the database connections on a preview build?
      instructions:
      - text: List the database connections on build {environmentName} of static site {name}.
        slots:
          environmentName: path.environmentName
          name: path.name
      - text: Give me an overview of databases linked to environment {environmentName} of static web app {name}.
        slots:
          environmentName: path.environmentName
          name: 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 on a static site build
      effect: read
      questions:
      - Can I look up one named database connection on a specific static site build?
      - What resource does a given database connection on a preview environment point to?
      instructions:
      - text: Get database connection {databaseConnectionName} on build {environmentName} of static site {name}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          environmentName: path.environmentName
          name: path.name
      - text: Show the overview of build-level database connection {databaseConnectionName} in environment {environmentName}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          environmentName: 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 connect a database to only one preview environment of my static web app?
      - How do I attach a database to a specific static site build?
      instructions:
      - text: Create database connection {databaseConnectionName} on build {environmentName} of static site {name} with {properties}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          environmentName: path.environmentName
          name: path.name
          properties: requestBody.properties
      - text: Connect a database called {databaseConnectionName} to the {environmentName} build of static web app {name}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          environmentName: path.environmentName
          name: path.name
      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:
      - Can I disconnect a database from just one build environment of my static site?
      - What removes a database link from a preview environment?
      instructions:
      - text: Delete database connection {databaseConnectionName} from build {environmentName} of static site {name}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          environmentName: path.environmentName
          name: path.name
      - text: Disconnect the build-level database {databaseConnectionName} from environment {environmentName}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          environmentName: 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 an existing database connection on a preview build without recreating it?
      - Is there a partial update for a build environment's database connection?
      instructions:
      - text: Patch database connection {databaseConnectionName} on build {environmentName} of static site {name} with {properties}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          environmentName: path.environmentName
          name: path.name
          properties: requestBody.properties
      - text: Partially update the existing build database connection {databaseConnectionName} in environment {environmentName}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          environmentName: path.environmentName
      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:
      - Can I see the full details, not just the overview, of a database connection on a static site build?
      - What configuration is behind a specific database connection on my preview environment?
      instructions:
      - text: Show full details of database connection {databaseConnectionName} on build {environmentName} of static site {name}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          environmentName: path.environmentName
          name: path.name
      - text: Reveal the detailed configuration of build database connection {databaseConnectionName} in {environmentName}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          environmentName: 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 in one build environment of my static web app?
      - Can I list the functions shipped with a specific preview build?
      instructions:
      - text: List the functions in build {environmentName} of static site {name}.
        slots:
          environmentName: path.environmentName
          name: path.name
      - text: Show the API functions deployed to environment {environmentName} of static web app {name}.
        slots:
          environmentName: path.environmentName
          name: 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:
      - Which backends are linked to one build environment of my static site?
      - Can I see all linked backends for a specific preview environment?
      instructions:
      - text: List the linked backends on build {environmentName} of static site {name}.
        slots:
          environmentName: path.environmentName
          name: path.name
      - text: Show every backend attached to environment {environmentName} of static web app {name}.
        slots:
          environmentName: path.environmentName
          name: path.name
      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:
      - Can I look up one named backend linked to a particular static site build?
      - What region and resource does a linked backend on my preview environment use?
      instructions:
      - text: Get linked backend {linkedBackendName} on build {environmentName} of static site {name}.
        slots:
          linkedBackendName: path.linkedBackendName
          environmentName: path.environmentName
          name: path.name
      - text: Show the build-level backend link {linkedBackendName} in environment {environmentName}.
        slots:
          linkedBackendName: path.linkedBackendName
          environmentName: 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 just one preview environment of my static web app at a different backend API?
      - How do I link a backend to a specific static site build?
      instructions:
      - text: Link backend {linkedBackendName} to build {environmentName} of static site {name} using {properties}.
        slots:
          linkedBackendName: path.linkedBackendName
          environmentName: path.environmentName
          name: path.name
          properties: requestBody.properties
      - text: Attach backend {linkedBackendName} to the {environmentName} environment only.
        slots:
          linkedBackendName: path.linkedBackendName
          environmentName: path.environmentName
      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:
      - Can I detach a backend from just one build environment of my static site?
      - When I unlink a backend from a preview build, can I also clean up its auth configuration?
      instructions:
      - text: Unlink backend {linkedBackendName} from build {environmentName} of static site {name}.
        slots:
          linkedBackendName: path.linkedBackendName
          environmentName: path.environmentName
          name: path.name
      - text: Unlink build backend {linkedBackendName} from {environmentName} and set auth cleanup to {isCleaningAuthConfig}.
        slots:
          linkedBackendName: path.linkedBackendName
          environmentName: path.environmentName
          isCleaningAuthConfig: query.isCleaningAuthConfig
      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 link to a static site build
      effect: read
      questions:
      - Will this backend be accepted if I link it to my preview environment?
      - Can I validate a backend against a specific static site build before linking it?
      instructions:
      - text: Validate that backend {linkedBackendName} can be linked to build {environmentName} of static site {name}.
        slots:
          linkedBackendName: path.linkedBackendName
          environmentName: path.environmentName
          name: path.name
      - text: Dry-run a build backend link for {linkedBackendName} on {environmentName} with {properties}.
        slots:
          linkedBackendName: path.linkedBackendName
          environmentName: path.environmentName
          properties: requestBody.properties
      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 app settings are currently set on one build environment of my static site?
      - Can I read back the environment variables configured for a preview build?
      instructions:
      - text: List the app settings on build {environmentName} of static site {name}.
        slots:
          environmentName: path.environmentName
          name: path.name
      - text: Read back the build-level application settings for environment {environmentName}.
        slots:
          environmentName: path.environmentName
      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:
      - Which function app settings does one preview environment of my static site have?
      - Can I check the managed functions' settings on a specific static site build?
      instructions:
      - text: Read the managed function settings for build {environmentName} of static site {name}.
        slots:
          environmentName: path.environmentName
          name: path.name
      - text: Read back the build-level function settings for environment {environmentName}.
        slots:
          environmentName: 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 details of all database connections on a build
      effect: read
      questions:
      - Can I get the detailed configuration of every database connection on a preview build at once?
      - What full details exist for all databases connected to one static site build?
      instructions:
      - text: Show detailed database connections for build {environmentName} of static site {name}.
        slots:
          environmentName: path.environmentName
          name: path.name
      - text: Reveal full details of every build database connection in environment {environmentName}.
        slots:
          environmentName: 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 build
      effect: read
      questions:
      - Which of my own function apps are registered with a particular static site build?
      - Can I see the bring-your-own Functions backends on a preview environment?
      instructions:
      - text: List user-provided function apps on build {environmentName} of static site {name}.
        slots:
          environmentName: path.environmentName
          name: path.name
      - text: Show the bring-your-own function apps registered to environment {environmentName}.
        slots:
          environmentName: 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 build
      effect: read
      questions:
      - Can I look up one registered function app on a specific static site build?
      - What are the details of my own function app attached to a preview environment?
      instructions:
      - text: Get user-provided function app {functionAppName} on build {environmentName} of static site {name}.
        slots:
          functionAppName: path.functionAppName
          environmentName: path.environmentName
          name: path.name
      - text: Show the build-level registration of function app {functionAppName} in {environmentName}.
        slots:
          functionAppName: path.functionAppName
          environmentName: 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 build
      effect: write
      questions:
      - Can I use my existing Azure Functions app as the API for one preview environment?
      - Is there a force option when registering a function app with a static site build?
      instructions:
      - text: Register function app {functionAppName} with build {environmentName} of static site {name}.
        slots:
          functionAppName: path.functionAppName
          environmentName: path.environmentName
          name: path.name
      - text: Force-register function app {functionAppName} on environment {environmentName} with isForced {isForced}.
        slots:
          functionAppName: path.functionAppName
          environmentName: path.environmentName
          isForced: 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 build
      effect: destructive
      questions:
      - Can I stop one preview environment from using my registered function app?
      - What detaches a bring-your-own function app from a specific build?
      instructions:
      - text: Detach function app {functionAppName} from build {environmentName} of static site {name}.
        slots:
          functionAppName: path.functionAppName
          environmentName: path.environmentName
          name: path.name
      - text: Remove the build-level function app registration {functionAppName} from {environmentName}.
        slots:
          functionAppName: path.functionAppName
          environmentName: 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: Zip-deploy content to a static site environment
      effect: write
      questions:
      - Can I push a zip of my built site straight to one environment of my static web app?
      - How do I deploy zipped content to a preview environment without a CI pipeline?
      instructions:
      - text: Zip-deploy {properties} to environment {environmentName} of static site {name}.
        slots:
          properties: requestBody.properties
          environmentName: path.environmentName
          name: path.name
      - text: Upload a zipped build into the {environmentName} environment of static web app {name}.
        slots:
          environmentName: path.environmentName
          name: path.name
      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 site
      effect: write
      questions:
      - How do I set site-wide environment variables on my static web app?
      - Can I replace the production app settings of a static site in one call?
      instructions:
      - text: Set app settings {properties} on static site {name}.
        slots:
          properties: requestBody.properties
          name: path.name
      - text: Overwrite the site-wide application settings of static web app {name}.
        slots:
          name: path.name
      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 site
      effect: write
      questions:
      - Where do I configure settings for the managed API functions of my whole static site?
      - Can I update the site-wide function app settings of a static web app?
      instructions:
      - text: Configure the managed API functions of static site {name} with settings {properties}.
        slots:
          properties: requestBody.properties
          name: path.name
      - text: Overwrite the site-wide function settings of static web app {name}.
        slots:
          name: 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:
      - Can I invite someone to my static web app with a specific role?
      - How do I generate an invitation link that grants a user roles on a static site?
      instructions:
      - text: Create an invitation link for static site {name} with {properties}.
        slots:
          name: path.name
          properties: requestBody.properties
      - text: Generate a role invitation for a new user on static web app {name}.
        slots:
          name: path.name
      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 site
      effect: read
      questions:
      - Which custom domains are attached to my static web app?
      - Can I see all hostnames I've mapped to a static site?
      instructions:
      - text: List the custom domains on static site {name}.
        slots:
          name: path.name
      - text: Show every hostname mapped to static web app {name}.
        slots:
          name: 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 of a static site
      effect: read
      questions:
      - What is the validation status of one custom domain on my static site?
      - Can I look up a single custom domain mapping by its hostname?
      instructions:
      - text: Get custom domain {domainName} on static site {name}.
        slots:
          domainName: path.domainName
          name: path.name
      - text: Show the status of hostname {domainName} on static web app {name}.
        slots:
          domainName: path.domainName
          name: 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 site
      effect: write
      questions:
      - How do I put my own domain name on a static web app?
      - Can I attach a new custom hostname to an existing static site?
      instructions:
      - text: Add custom domain {domainName} to static site {name}.
        slots:
          domainName: path.domainName
          name: path.name
      - text: Map hostname {domainName} to static web app {name} with {properties}.
        slots:
          domainName: path.domainName
          name: 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 site
      effect: destructive
      questions:
      - Can I take a custom domain off my static web app?
      - What removes a hostname mapping I no longer use from a static site?
      instructions:
      - text: Delete custom domain {domainName} from static site {name}.
        slots:
          domainName: path.domainName
          name: path.name
      - text: Unmap hostname {domainName} from static web app {name}.
        slots:
          domainName: path.domainName
          name: 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:
      - Will my domain pass validation before I try attaching it to a static web app?
      - Can I pre-check that a hostname is eligible for my static site?
      instructions:
      - text: Validate that domain {domainName} can be added to static site {name}.
        slots:
          domainName: path.domainName
          name: path.name
      - text: Pre-check hostname {domainName} for static web app {name} with {properties}.
        slots:
          domainName: path.domainName
          name: path.name
          properties: requestBody.properties
      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 for a static site
      effect: read
      questions:
      - Which databases are connected to my static web app at the site level?
      - Can I get an overview of every database connection on a static site?
      instructions:
      - text: List the database connections on static site {name}.
        slots:
          name: path.name
      - text: Give me an overview of site-level databases linked to static web app {name}.
        slots:
          name: 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 for a static site
      effect: read
      questions:
      - Can I look up one named site-level database connection on my static web app?
      - What database resource does a particular static site connection point to?
      instructions:
      - text: Get database connection {databaseConnectionName} on static site {name}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          name: path.name
      - text: Show the overview of site-level database connection {databaseConnectionName} on {name}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          name: 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 site
      effect: write
      questions:
      - How do I connect a database to my static web app for all environments?
      - Can I create or replace a site-level database connection on a static site?
      instructions:
      - text: Create database connection {databaseConnectionName} on static site {name} with {properties}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          name: path.name
          properties: requestBody.properties
      - text: Connect a site-level database called {databaseConnectionName} to static web app {name}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          name: path.name
      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 site
      effect: destructive
      questions:
      - Can I disconnect a database from my static web app at the site level?
      - What removes a site-wide database connection from a static site?
      instructions:
      - text: Delete database connection {databaseConnectionName} from static site {name}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          name: path.name
      - text: Disconnect site-level database {databaseConnectionName} from static web app {name}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          name: 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 for a static site
      effect: write
      questions:
      - Can I tweak an existing site-level database connection without recreating it?
      - Is there a partial update for a static site's database connection?
      instructions:
      - text: Patch database connection {databaseConnectionName} on static site {name} with {properties}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          name: path.name
          properties: requestBody.properties
      - text: Partially update the site-level database connection {databaseConnectionName} on {name}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          name: path.name
      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 static site database connection
      effect: read
      questions:
      - Can I see the full details, beyond the overview, of one site-level database connection?
      - What complete configuration sits behind a database connection on my static web app?
      instructions:
      - text: Expand site-level database connection {databaseConnectionName} on static site {name} with all its details.
        slots:
          databaseConnectionName: path.databaseConnectionName
          name: path.name
      - text: Reveal the detailed configuration of site-level database connection {databaseConnectionName} on {name}.
        slots:
          databaseConnectionName: path.databaseConnectionName
          name: 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 site
      effect: write
      questions:
      - Can I detach a static web app from its source so it stops being tied to it?
      - What does detaching a static site do to the resource?
      instructions:
      - text: Detach static site {name}.
        slots:
          name: path.name
      - text: Run the detach action on static web app {name}.
        slots:
          name: 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 site
      effect: read
      questions:
      - Which API functions does my static web app expose in production?
      - Can I list the site-level functions of a static site?
      instructions:
      - text: List the functions of static site {name}.
        slots:
          name: path.name
      - text: Show the site-level API functions deployed on static web app {name}.
        slots:
          name: path.name
      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 site
      effect: read
      questions:
      - Which backends are linked to my static web app across the site?
      - Can I see all site-level linked backends for a static site?
      instructions:
      - text: List the linked backends on static site {name}.
        slots:
          name: path.name
      - text: Show every site-level backend attached to static web app {name}.
        slots:
          name: path.name
      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 site
      effect: read
      questions:
      - Can I look up one site-level linked backend by name?
      - What resource does a named backend link on my static web app point to?
      instructions:
      - text: Get linked backend {linkedBackendName} on static site {name}.
        slots:
          linkedBackendName: path.linkedBackendName
          name: path.name
      - text: Show the site-level backend link {linkedBackendName} on static web app {name}.
        slots:
          linkedBackendName: path.linkedBackendName
          name: 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 site
      effect: write
      questions:
      - How do I connect an existing backend API to my whole static web app?
      - Can I link a backend at the site level rather than per environment?
      instructions:
      - text: Link backend {linkedBackendName} to static site {name} using {properties}.
        slots:
          linkedBackendName: path.linkedBackendName
          name: path.name
          properties: requestBody.properties
      - text: Attach backend {linkedBackendName} to static web app {name} for all environments.
        slots:
          linkedBackendName: path.linkedBackendName
          name: path.name
      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 site
      effect: destructive
      questions:
      - Can I detach a site-level backend from my static web app?
      - Does unlinking a backend from a static site let me clean up its auth config too?
      instructions:
      - text: Unlink backend {linkedBackendName} from static site {name}.
        slots:
          linkedBackendName: path.linkedBackendName
          name: path.name
      - text: Unlink site-level backend {linkedBackendName} from {name} with auth cleanup {isCleaningAuthConfig}.
        slots:
          linkedBackendName: path.linkedBackendName
          name: path.name
          isCleaningAuthConfig: query.isCleaningAuthConfig
      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 link to a static site
      effect: read
      questions:
      - Will this backend be accepted if I link it to my static web app site-wide?
      - Can I validate a site-level backend link before making it?
      instructions:
      - text: Validate that backend {linkedBackendName} can be linked to static site {name}.
        slots:
          linkedBackendName: path.linkedBackendName
          name: path.name
      - text: Dry-run a site-level backend link for {linkedBackendName} on {name} with {properties}.
        slots:
          linkedBackendName: path.linkedBackendName
          name: path.name
          properties: requestBody.properties
      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 site
      effect: read
      questions:
      - What site-wide app settings are configured on my static web app?
      - Can I read back the production environment variables of a static site?
      instructions:
      - text: List the app settings of static site {name}.
        slots:
          name: path.name
      - text: Read back the site-wide application settings for static web app {name}.
        slots:
          name: 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 site
      effect: read
      questions:
      - Which custom roles are defined on my static web app?
      - Can I see what roles users can be assigned on a static site?
      instructions:
      - text: List the configured roles for static site {name}.
        slots:
          name: path.name
      - text: Show the role names available on static web app {name}.
        slots:
          name: 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 site
      effect: read
      questions:
      - What site-wide function app settings does my static web app have?
      - Can I check the managed API functions' settings for the whole static site?
      instructions:
      - text: Read the managed API function settings for static site {name}.
        slots:
          name: path.name
      - text: Read back the site-wide function settings for static web app {name}.
        slots:
          name: 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 the secrets of a static site
      effect: read
      questions:
      - Where can I find the deployment token and other secrets for my static web app?
      - Can I retrieve the secrets of an existing static site?
      instructions:
      - text: List the secrets for static site {name}.
        slots:
          name: path.name
      - text: Fetch the deployment secrets of static web app {name}.
        slots:
          name: 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 see all private endpoint connections and their approval states on a static site?
      instructions:
      - text: List the private endpoint connections on static site {name}.
        slots:
          name: path.name
      - text: Show every private endpoint linked to static web app {name}.
        slots:
          name: 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 specific private endpoint connection on my static site approved or pending?
      - Can I look up one private endpoint connection by name?
      instructions:
      - text: Get private endpoint connection {privateEndpointConnectionName} on static site {name}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          name: path.name
      - text: Show the approval state of private endpoint {privateEndpointConnectionName} on {name}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          name: path.name
      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 on my static web app?
      - Can I reject a private endpoint connection someone requested to my static site?
      instructions:
      - text: Approve private endpoint connection {privateEndpointConnectionName} on static site {name}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          name: path.name
      - text: Set private endpoint {privateEndpointConnectionName} on {name} to {properties}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          name: path.name
          properties: requestBody.properties
      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
      effect: destructive
      questions:
      - Can I remove a private endpoint connection from my static web app entirely?
      - What deletes a private endpoint link on a static site?
      instructions:
      - text: Delete private endpoint connection {privateEndpointConnectionName} from static site {name}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          name: path.name
      - text: Remove the private endpoint {privateEndpointConnectionName} from static web app {name}.
        slots:
          privateEndpointConnectionName: path.privateEndpointConnectionName
          name: 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: Get private link resources for a static site
      effect: read
      questions:
      - Which private link resource types can my static web app expose?
      - What group IDs are available for creating a private endpoint to a static site?
      instructions:
      - text: Get the private link resources for static site {name}.
        slots:
          name: path.name
      - text: Show the private link group IDs supported by static web app {name}.
        slots:
          name: 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 API key of a static site
      effect: destructive
      questions:
      - How do I rotate the deployment API key of my static web app if it leaked?
      - Can I reset a static site's API key, invalidating the old one?
      instructions:
      - text: Reset the API key for static site {name}.
        slots:
          name: path.name
      - text: Rotate the deployment key of static web app {name} with {properties}.
        slots:
          name: path.name
          properties: requestBody.properties
      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 details of all database connections on a site
      effect: read
      questions:
      - Can I get the detailed configuration of every site-level database connection at once?
      - What full details exist for all databases connected to my static web app?
      instructions:
      - text: Show detailed database connections for static site {name}.
        slots:
          name: path.name
      - text: Reveal full details of every site-level database connection on static web app {name}.
        slots:
          name: 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 the bring-your-own Functions backends for a whole static site?
      instructions:
      - text: List user-provided function apps on static site {name}.
        slots:
          name: path.name
      - text: Show the site-level bring-your-own function apps of static web app {name}.
        slots:
          name: 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:
      - Can I look up one site-level registered function app on my static web app?
      - What are the details of my own function app attached to a static site?
      instructions:
      - text: Get user-provided function app {functionAppName} on static site {name}.
        slots:
          functionAppName: path.functionAppName
          name: path.name
      - text: Show the site-level registration of function app {functionAppName} on {name}.
        slots:
          functionAppName: path.functionAppName
          name: 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 my existing Azure Functions app as the API for my whole static web app?
      - Is there a force flag when registering a function app with a static site?
      instructions:
      - text: Register function app {functionAppName} with static site {name}.
        slots:
          functionAppName: path.functionAppName
          name: path.name
      - text: Force-register site-level function app {functionAppName} on {name} with isForced {isForced}.
        slots:
          functionAppName: path.functionAppName
          name: path.name
          isForced: 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:
      - Can I stop my static web app from using a registered function app site-wide?
      - What detaches a bring-your-own function app from a static site?
      instructions:
      - text: Detach function app {functionAppName} from static site {name}.
        slots:
          functionAppName: path.functionAppName
          name: path.name
      - text: Remove the site-level function app registration {functionAppName} from {name}.
        slots:
          functionAppName: path.functionAppName
          name: 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: Zip-deploy content to a static site
      effect: write
      questions:
      - Can I deploy my static site by uploading a zip instead of running a CI workflow?
      - How do I push zipped content to the production static web app?
      instructions:
      - text: Zip-deploy {properties} to static site {name}.
        slots:
          properties: requestBody.properties
          name: path.name
      - text: Upload a zipped build to the production site of static web app {name}.
        slots:
          name: 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 site by auth provider
      effect: read
      questions:
      - Who has been granted access to my static web app through a given identity provider?
      - Can I list the users and their roles on a static site for one auth provider?
      instructions:
      - text: List users of static site {name} from auth provider {authprovider}.
        slots:
          name: path.name
          authprovider: path.authprovider
      - text: Show who signs in to static web app {name} via {authprovider}.
        slots:
          name: path.name
          authprovider: 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 site
      effect: destructive
      questions:
      - Can I revoke a user's access to my static web app?
      - What removes a single user entry from a static site?
      instructions:
      - text: Delete user {userid} from auth provider {authprovider} on static site {name}.
        slots:
          userid: path.userid
          authprovider: path.authprovider
          name: path.name
      - text: Revoke access for user {userid} on static web app {name} via {authprovider}.
        slots:
          userid: path.userid
          name: path.name
          authprovider: path.authprovider
      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: Update a static site user's roles
      effect: write
      questions:
      - How do I change the roles assigned to an existing user of my static web app?
      - Can I give a static site user additional roles?
      instructions:
      - text: Update the roles of user {userid} from {authprovider} on static site {name} to {properties}.
        slots:
          userid: path.userid
          authprovider: path.authprovider
          name: path.name
          properties: requestBody.properties
      - text: Change the role list for user {userid} on static web app {name} via {authprovider}.
        slots:
          userid: path.userid
          name: path.name
          authprovider: path.authprovider
      method: generated
      generated: '2026-10-01'