Microsoft Azure Functions StaticSites API

openapi: 3.2.0
info:
  title: WebApps API Client AppServiceEnvironments Static Sites API
  version: '2025-05-01'
  x-typespec-generated:
  - emitter: '@azure-tools/typespec-autorest'
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: StaticSites
paths:
  /subscriptions/{subscriptionId}/providers/Microsoft.Web/locations/{location}/previewStaticSiteWorkflowFile:
    post:
      operationId: StaticSites_PreviewWorkflow
      tags:
      - StaticSites
      summary: Generates a preview workflow file for the static site
      description: Description for Generates a preview workflow file for the static site
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/LocationParameter
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSitesWorkflowPreview'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Generates a preview workflow file for the static site:
          $ref: ./examples/GenerateStaticSiteWorkflowPreview.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StaticSitesWorkflowPreviewRequest'
        description: The request body
        required: true
  /subscriptions/{subscriptionId}/providers/Microsoft.Web/staticSites:
    get:
      operationId: StaticSites_List
      tags:
      - StaticSites
      summary: Get all Static Sites for a subscription.
      description: Description for Get all Static Sites for a subscription.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSiteCollection'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Get all static sites in a subscription:
          $ref: ./examples/GetAllStaticSites.json
      x-ms-pageable:
        nextLinkName: nextLink
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites:
    get:
      operationId: StaticSites_GetStaticSitesByResourceGroup
      tags:
      - StaticSites
      summary: Gets all static sites in the specified resource group.
      description: Description for Gets all static sites in the specified resource group.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSiteCollection'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Get static sites for a resource group:
          $ref: ./examples/GetStaticSites.json
      x-ms-pageable:
        nextLinkName: nextLink
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}:
    get:
      operationId: StaticSites_GetStaticSite
      tags:
      - StaticSites
      summary: Gets the details of a static site.
      description: Description for Gets the details of a static site.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSiteARMResource'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Get details for a static site:
          $ref: ./examples/GetStaticSite.json
    put:
      operationId: StaticSites_CreateOrUpdateStaticSite
      tags:
      - StaticSites
      summary: Creates a new static site in an existing resource group, or updates an existing static site.
      description: Description for Creates a new static site in an existing resource group, or updates an existing static site.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Resource 'StaticSiteARMResource' update operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSiteARMResource'
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          headers:
            Location:
              description: The Location header contains the URL where the status of the long running operation can be checked.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSiteARMResource'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Create or update a static site:
          $ref: ./examples/CreateOrUpdateStaticSite.json
      x-ms-long-running-operation-options:
        final-state-via: location
        final-state-schema: '#/definitions/StaticSiteARMResource'
      x-ms-long-running-operation: true
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StaticSiteARMResource'
        description: A JSON representation of the staticsite properties. See example.
        required: true
    patch:
      operationId: StaticSites_UpdateStaticSite
      tags:
      - StaticSites
      summary: Creates a new static site in an existing resource group, or updates an existing static site.
      description: Description for Creates a new static site in an existing resource group, or updates an existing static site.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSiteARMResource'
        '202':
          description: The request has been accepted for processing, but processing has not yet completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSiteARMResource'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Patch a static site:
          $ref: ./examples/PatchStaticSite.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StaticSitePatchResource'
        description: A JSON representation of the staticsite properties. See example.
        required: true
    delete:
      operationId: StaticSites_DeleteStaticSite
      tags:
      - StaticSites
      summary: Deletes a static site.
      description: Description for Deletes a static site.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Resource deleted successfully.
        '202':
          description: Resource deletion accepted.
          headers:
            Location:
              description: The Location header contains the URL where the status of the long running operation can be checked.
              schema:
                type: string
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              schema:
                type: integer
                format: int32
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Delete a static site:
          $ref: ./examples/DeleteStaticSite.json
      x-ms-long-running-operation-options:
        final-state-via: location
      x-ms-long-running-operation: true
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/basicAuth:
    get:
      operationId: StaticSites_ListBasicAuth
      tags:
      - StaticSites
      summary: Gets the basic auth properties for a static site as a collection.
      description: Description for Gets the basic auth properties for a static site as a collection.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSiteBasicAuthPropertiesCollection'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Lists the basic auth properties for a static site.:
          $ref: ./examples/ListStaticSiteBasicAuth.json
      x-ms-pageable:
        nextLinkName: nextLink
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/basicAuth/{basicAuthName}
  : get:
      operationId: StaticSites_GetBasicAuth
      tags:
      - StaticSites
      summary: Gets the basic auth properties for a static site.
      description: Description for Gets the basic auth properties for a static site.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site.
        required: true
        schema:
          type: string
      - name: basicAuthName
        in: path
        description: name of the basic auth entry.
        required: true
        x-ms-enum:
          name: BasicAuthName
          modelAsString: true
          values:
          - name: default
            value: default
        schema:
          type: string
          enum:
          - default
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSiteBasicAuthPropertiesARMResource'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Gets the basic auth properties for a static site.:
          $ref: ./examples/GetStaticSiteBasicAuth.json
    put:
      operationId: StaticSites_CreateOrUpdateBasicAuth
      tags:
      - StaticSites
      summary: Adds or updates basic auth for a static site.
      description: Description for Adds or updates basic auth for a static site.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site.
        required: true
        schema:
          type: string
      - name: basicAuthName
        in: path
        description: name of the basic auth entry.
        required: true
        x-ms-enum:
          name: BasicAuthName
          modelAsString: true
          values:
          - name: default
            value: default
        schema:
          type: string
          enum:
          - default
      responses:
        '200':
          description: Resource 'StaticSiteBasicAuthPropertiesARMResource' update operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSiteBasicAuthPropertiesARMResource'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Creates or updates basic auth properties for a static site.:
          $ref: ./examples/CreateOrUpdateStaticSiteBasicAuth.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StaticSiteBasicAuthPropertiesARMResource'
        description: A JSON representation of the basic auth properties.
        required: true
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds:
    get:
      operationId: StaticSites_GetStaticSiteBuilds
      tags:
      - StaticSites
      summary: Gets all static site builds for a particular static site.
      description: Description for Gets all static site builds for a particular static site.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSiteBuildCollection'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Get all builds for a static site:
          $ref: ./examples/GetStaticSiteBuilds.json
      x-ms-pageable:
        nextLinkName: nextLink
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}
  : get:
      operationId: StaticSites_GetStaticSiteBuild
      tags:
      - StaticSites
      summary: Gets the details of a static site build.
      description: Description for Gets the details of a static site build.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site.
        required: true
        schema:
          type: string
      - name: environmentName
        in: path
        description: The stage site identifier.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StaticSiteBuildARMResource'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Get a static site build:
          $ref: ./examples/GetStaticSiteBuild.json
    delete:
      operationId: StaticSites_DeleteStaticSiteBuild
      tags:
      - StaticSites
      summary: Deletes a static site build.
      description: Description for Deletes a static site build.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site.
        required: true
        schema:
          type: string
      - name: environmentName
        in: path
        description: The stage site identifier.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+$
      responses:
        '200':
          description: Resource deleted successfully.
        '202':
          description: Resource deletion accepted.
          headers:
            Location:
              description: The Location header contains the URL where the status of the long running operation can be checked.
              schema:
                type: string
            Retry-After:
              description: The Retry-After header can indicate how long the client should wait before polling the operation status.
              schema:
                type: integer
                format: int32
        '204':
          description: Resource does not exist.
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Delete a static site build:
          $ref: ./examples/DeleteStaticSiteBuild.json
      x-ms-long-running-operation-options:
        final-state-via: location
      x-ms-long-running-operation: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/config/appsettings
  : put:
      operationId: StaticSites_CreateOrUpdateStaticSiteBuildAppSettings
      tags:
      - StaticSites
      summary: Creates or updates the app settings of a static site build.
      description: Description for Creates or updates the app settings of a static site build.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site.
        required: true
        schema:
          type: string
      - name: environmentName
        in: path
        description: The stage site identifier.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StringDictionary'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Creates or updates the function app settings of a static site build.:
          $ref: ./examples/CreateOrUpdateStaticSiteBuildAppSettings.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StringDictionary'
        description: The dictionary containing the static site app settings to update.
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/config/functionappsettings
  : put:
      operationId: StaticSites_CreateOrUpdateStaticSiteBuildFunctionAppSettings
      tags:
      - StaticSites
      summary: Creates or updates the function app settings of a static site build.
      description: Description for Creates or updates the function app settings of a static site build.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site.
        required: true
        schema:
          type: string
      - name: environmentName
        in: path
        description: The stage site identifier.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StringDictionary'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Creates or updates the function app settings of a static site build.:
          $ref: ./examples/CreateOrUpdateStaticSiteBuildFunctionAppSettings.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StringDictionary'
        description: The dictionary containing the static site function app settings to update.
        required: true
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/databaseConnections
  : get:
      operationId: StaticSites_GetBuildDatabaseConnections
      tags:
      - StaticSites
      summary: Returns overviews of database connections for a static site build
      description: Returns overviews of database connections for a static site build
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site
        required: true
        schema:
          type: string
      - name: environmentName
        in: path
        description: The stage site identifier.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatabaseConnectionCollection'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        List overviews of database connections for the static site build.:
          $ref: ./examples/GetStaticSiteBuildDatabaseConnections.json
      x-ms-pageable:
        nextLinkName: nextLink
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/staticSites/{name}/builds/{environmentName}/databaseConnections/{databaseConnectionName}
  : get:
      operationId: StaticSites_GetBuildDatabaseConnection
      tags:
      - StaticSites
      summary: Returns overview of a database connection for a static site build by name
      description: Returns overview of a database connection for a static site build by name
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site
        required: true
        schema:
          type: string
      - name: environmentName
        in: path
        description: The stage site identifier.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+$
      - name: databaseConnectionName
        in: path
        description: Name of the database connection.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatabaseConnection'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Get overview of database connections for the static site build.:
          $ref: ./examples/GetStaticSiteBuildDatabaseConnection.json
    put:
      operationId: StaticSites_CreateOrUpdateBuildDatabaseConnection
      tags:
      - StaticSites
      summary: Create or update a database connection for a static site build
      description: Description for Create or update a database connection for a static site build
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site
        required: true
        schema:
          type: string
      - name: environmentName
        in: path
        description: The stage site identifier.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+$
      - name: databaseConnectionName
        in: path
        description: Name of the database connection.
        required: true
        schema:
          type: string
          pattern: ^[a-zA-Z0-9]+$
      responses:
        '200':
          description: Resource 'DatabaseConnection' update operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatabaseConnection'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DefaultErrorResponse'
      x-ms-examples:
        Create or update a database connection for a static site build:
          $ref: ./examples/CreateOrUpdateStaticSiteBuildDatabaseConnection.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DatabaseConnection'
        description: A JSON representation of the database connection request properties
        required: true
    patch:
      operationId: StaticSites_UpdateBuildDatabaseConnection
      tags:
      - StaticSites
      summary: Create or update a database connection for a static site build
      description: Description for Create or update a database connection for a static site build
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/SubscriptionIdParameter
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ResourceGroupNameParameter
      - name: name
        in: path
        description: Name of the static site
        required: true
        schema:
          type: string
      - na

# --- truncated at 32 KB (186 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure-functions/refs/heads/main/openapi/microsoft-azure-functions-staticsites-api-openapi.yml