API Evangelist conversational phrasing for WebApps API Client Static Sites API

# 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'


# --- truncated at 32 KB (65 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure-functions/refs/heads/main/overlays/microsoft-azure-functions-static-sites-api-phrasing-overlay.yaml