# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure AppPlatformManagementClient App Platform API
  version: 1.0.0
extends: openapi/microsoft-azure-appplatform-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: 169
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Spring Apps service instance
      effect: read
      questions:
      - What SKU and properties does my Azure Spring Apps instance have?
      - Can I look up a single Spring Apps service by name to see its properties?
      instructions:
      - text: Show me the properties of Spring Apps service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Fetch the details of service instance {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace a Spring Apps service
      effect: write
      questions:
      - How do I provision a new Spring Apps service instance with a chosen SKU and region?
      - Can I tag a Spring Apps instance when I first create it?
      instructions:
      - text: Create Spring Apps service {service} in {location} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          location: requestBody.location
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Provision service {service} on the {sku} SKU with tags {tags}.
        slots:
          service: path.serviceName
          sku: requestBody.sku
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Spring Apps service instance
      effect: destructive
      questions:
      - How do I tear down a whole Spring Apps service instance I no longer need?
      - What happens to apps when I delete the Spring Apps service that hosts them?
      instructions:
      - text: Delete Spring Apps service {service} from resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the entire service instance {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch settings on an existing Spring Apps service
      effect: write
      questions:
      - Can I change the SKU of a Spring Apps service that already exists without recreating it?
      - How do I add or change tags on a running Spring Apps instance?
      instructions:
      - text: Patch existing service {service} in resource group {rg}, subscription {sub} to use SKU {sku}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          sku: requestBody.sku
      - text: Change only the tags on existing service {service} to {tags}.
        slots:
          service: path.serviceName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/listTestKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Show the test endpoint keys for a service
      effect: read
      questions:
      - Where do I find the test keys for my Spring Apps test endpoint?
      - Which keys let me call the test endpoint of a service?
      instructions:
      - text: List the test keys for service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show me the current test endpoint keys of {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/regenerateTestKey'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a service test key
      effect: write
      questions:
      - How do I rotate a leaked test endpoint key on my Spring Apps instance?
      - Can I regenerate one type of test key and keep the other?
      instructions:
      - text: Regenerate the {keyType} test key for service {service} in resource group {rg}, subscription {sub}.
        slots:
          keyType: requestBody.keyType
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Rotate the {keyType} key on the test endpoint of {service}.
        slots:
          keyType: requestBody.keyType
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/disableTestEndpoint'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn off the service test endpoint
      effect: write
      questions:
      - How do I stop exposing the test endpoint on a Spring Apps service?
      - Can I switch off test endpoint access entirely for an instance?
      instructions:
      - text: Disable the test endpoint on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Turn off test endpoint access for {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/enableTestEndpoint'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn on the service test endpoint
      effect: write
      questions:
      - How do I switch the test endpoint back on for a Spring Apps service?
      - Can I get a test endpoint to reach staging deployments before going live?
      instructions:
      - text: Enable the test endpoint on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Turn test endpoint access back on for {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a Spring Apps service instance
      effect: write
      questions:
      - How do I pause a whole Spring Apps instance to save cost overnight?
      - Can I stop every app on a service at once by stopping the service itself?
      instructions:
      - text: Stop Spring Apps service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Shut down the service instance {service} for now.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a stopped Spring Apps service
      effect: write
      questions:
      - How do I bring a stopped Spring Apps instance back online?
      - Can I restart a whole service instance after I stopped it?
      instructions:
      - text: Start Spring Apps service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Power the stopped service instance {service} back on.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/flushVirtualNetworkDnsSettings'].post
  update:
    x-apievangelist-phrasing:
      intent: Flush VNet DNS settings for a service
      effect: write
      questions:
      - My VNet-injected Spring Apps instance is not picking up new DNS servers - how do I refresh it?
      - Can I force a service to reload its virtual network DNS configuration?
      instructions:
      - text: Flush the virtual network DNS settings of service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Make VNet-injected service {service} pick up its updated DNS servers.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/supportedApmTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List APM types a service supports
      effect: read
      questions:
      - Which application performance monitoring tools can I plug into a Spring Apps service?
      - What APM types are available for my instance?
      instructions:
      - text: List the supported APM types for service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which APM types {service} can use.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/listGloballyEnabledApms'].post
  update:
    x-apievangelist-phrasing:
      intent: List APMs enabled globally on a service
      effect: read
      questions:
      - Which APMs are currently switched on for every app in my Spring Apps service?
      - How can I check what monitoring is enabled globally on an instance?
      instructions:
      - text: List the globally enabled APMs on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show me which APMs are on for all apps in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/enableApmGlobally'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable an APM for all apps in a service
      effect: write
      questions:
      - How do I turn on an APM for every app in a Spring Apps service at once?
      - Can I apply one APM configuration globally instead of per app?
      instructions:
      - text: Enable APM {resourceId} globally on service {service} in resource group {rg}, subscription {sub}.
        slots:
          resourceId: requestBody.resourceId
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Switch on APM {resourceId} for every app in {service}.
        slots:
          resourceId: requestBody.resourceId
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/disableApmGlobally'].post
  update:
    x-apievangelist-phrasing:
      intent: Disable a globally enabled APM
      effect: write
      questions:
      - How do I stop an APM from applying to all apps in my service?
      - Can I remove a global APM without deleting the APM resource itself?
      instructions:
      - text: Disable global APM {resourceId} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          resourceId: requestBody.resourceId
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Stop applying APM {resourceId} to all apps in {service}.
        slots:
          resourceId: requestBody.resourceId
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apms'].get
  update:
    x-apievangelist-phrasing:
      intent: List the APM configurations in a service
      effect: read
      questions:
      - What APM resources have been configured on my Spring Apps instance?
      - Can I see every APM set up in one service?
      instructions:
      - text: List all APMs on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the APM resources defined in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apms/{apmName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one APM configuration
      effect: read
      questions:
      - How do I view the settings of a specific APM by name?
      - What type and properties does a given APM resource have?
      instructions:
      - text: Get APM {apm} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          apm: path.apmName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show me the configuration of APM {apm}.
        slots:
          apm: path.apmName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apms/{apmName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update an APM configuration
      effect: write
      questions:
      - How do I add an APM configuration to my Spring Apps service?
      - Can I change the properties of an APM I already set up?
      instructions:
      - text: Create APM {apm} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          apm: path.apmName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update APM {apm} with properties {properties}.
        slots:
          apm: path.apmName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apms/{apmName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an APM configuration
      effect: destructive
      questions:
      - How do I remove an APM resource from a Spring Apps service?
      - Can I delete an APM I no longer use?
      instructions:
      - text: Delete APM {apm} from service {service} in resource group {rg}, subscription {sub}.
        slots:
          apm: path.apmName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the APM named {apm}.
        slots:
          apm: path.apmName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apms/{apmName}/listSecretKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Reveal an APM's secret keys
      effect: read
      questions:
      - Where can I read the sensitive values stored on an APM?
      - How do I retrieve the secret keys of an APM configuration?
      instructions:
      - text: List the secret keys of APM {apm} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          apm: path.apmName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Reveal the sensitive properties stored on APM {apm}.
        slots:
          apm: path.apmName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/eurekaServers'].get
  update:
    x-apievangelist-phrasing:
      intent: List Eureka server settings
      effect: read
      questions:
      - What Eureka server settings exist on my Spring Apps instance?
      - Can I list the Eureka servers configured for a service?
      instructions:
      - text: List the Eureka server settings for service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every Eureka server entry on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/eurekaServers/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the default Eureka server settings
      effect: read
      questions:
      - Is the built-in Eureka service registry enabled on my Spring Apps service?
      - How do I check the current default Eureka server configuration?
      instructions:
      - text: Get the default Eureka server settings of service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Tell me whether Eureka is enabled on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/eurekaServers/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace the Eureka server settings
      effect: write
      questions:
      - How do I overwrite the whole Eureka server configuration in one request?
      - Can I enable or disable Eureka by sending the full settings payload?
      instructions:
      - text: Replace the Eureka server settings on service {service} in resource group {rg}, subscription {sub} with {properties}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Overwrite Eureka config of {service} with a full payload.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/eurekaServers/default'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update Eureka server settings
      effect: write
      questions:
      - Can I change a single Eureka setting without resending the rest?
      - How do I patch just the enabled flag on the Eureka server?
      instructions:
      - text: Patch the Eureka server on service {service} in resource group {rg}, subscription {sub} with {properties}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Change only the Eureka fields I give you on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configServers/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the Spring Cloud Config Server settings
      effect: read
      questions:
      - Which git repository is my Spring Apps Config Server reading from?
      - How can I see the current Config Server settings and state?
      instructions:
      - text: Get the Config Server settings of service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show me the git backend configured for the Config Server on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configServers/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace the Config Server git settings
      effect: write
      questions:
      - How do I point the Config Server at a completely new git repository configuration?
      - Can I replace all Config Server settings in one call?
      instructions:
      - text: Replace the Config Server settings on service {service} in resource group {rg}, subscription {sub} with {properties}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Overwrite the whole Config Server git setup on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configServers/default'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update Config Server settings
      effect: write
      questions:
      - Can I change one Config Server git setting without resending everything?
      - How do I patch one field of my Config Server configuration?
      instructions:
      - text: Patch the Config Server on service {service} in resource group {rg}, subscription {sub} with {properties}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Update only the Config Server fields I specify on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configServers/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Check Config Server git settings are valid
      effect: read
      questions:
      - Will my Config Server git repo settings actually work before I save them?
      - Can I test Config Server git properties for errors?
      instructions:
      - text: Validate Config Server git settings {gitProperty} for service {service} in resource group {rg}, subscription {sub}.
        slots:
          gitProperty: requestBody.gitProperty
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Dry-run check whether Config Server git property {gitProperty} is valid on {service}.
        slots:
          gitProperty: requestBody.gitProperty
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configurationServices/{configurationServiceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Application Configuration Service
      effect: read
      questions:
      - What git repositories does my Application Configuration Service pull config from?
      - How can I inspect the Application Configuration Service on an Enterprise instance?
      instructions:
      - text: Get Application Configuration Service {config_service} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          config_service: path.configurationServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the settings of Application Configuration Service {config_service}.
        slots:
          config_service: path.configurationServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configurationServices/{configurationServiceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable or update Application Configuration Service
      effect: write
      questions:
      - How do I turn on the Application Configuration Service for my Enterprise tier instance?
      - Can I add another git repository to the Application Configuration Service?
      instructions:
      - text: Create Application Configuration Service {config_service} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          config_service: path.configurationServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update Application Configuration Service {config_service} with {properties}.
        slots:
          config_service: path.configurationServiceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configurationServices/{configurationServiceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable the Application Configuration Service
      effect: destructive
      questions:
      - How do I switch off the Application Configuration Service on my instance?
      - Can I remove the default Application Configuration Service entirely?
      instructions:
      - text: Disable Application Configuration Service {config_service} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          config_service: path.configurationServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Delete the Application Configuration Service {config_service}.
        slots:
          config_service: path.configurationServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configurationServices'].get
  update:
    x-apievangelist-phrasing:
      intent: List Application Configuration Services
      effect: read
      questions:
      - Is an Application Configuration Service set up on my Spring Apps service?
      - Can I list all Application Configuration Service resources in an instance?
      instructions:
      - text: List the Application Configuration Services on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every Application Configuration Service resource in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configurationServices/{configurationServiceName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate git settings for Application Config Service
      effect: read
      questions:
      - Can I check the git repos for my Application Configuration Service before applying them?
      - How do I find out why Application Configuration Service git settings fail?
      instructions:
      - text: Validate git settings {gitProperty} for Application Configuration Service {config_service} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          gitProperty: requestBody.gitProperty
          config_service: path.configurationServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check git property {gitProperty} against Application Configuration Service {config_service}.
        slots:
          gitProperty: requestBody.gitProperty
          config_service: path.configurationServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/configurationServices/{configurationServiceName}/validateResource'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a whole Application Config Service resource
      effect: read
      questions:
      - Can I validate a full Application Configuration Service resource payload, not just the git part?
      - How do I check an Application Configuration Service resource definition is valid?
      instructions:
      - text: Validate full resource {properties} of Application Configuration Service {config_service}, service {service}, group {rg}, sub {sub}.
        slots:
          properties: requestBody.properties
          config_service: path.configurationServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check the full resource definition of Application Configuration Service {config_service}.
        slots:
          config_service: path.configurationServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/serviceRegistries/{serviceRegistryName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the Service Registry
      effect: read
      questions:
      - What is the state of the Service Registry on my Enterprise instance?
      - Can I inspect the Service Registry resource by name?
      instructions:
      - text: Get Service Registry {service_registry} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service_registry: path.serviceRegistryName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the details of Service Registry {service_registry}.
        slots:
          service_registry: path.serviceRegistryName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/serviceRegistries/{serviceRegistryName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable or update the Service Registry
      effect: write
      questions:
      - How do I turn on the managed Service Registry for my Spring Apps service?
      - Can I create the default Service Registry through the API?
      instructions:
      - text: Create Service Registry {service_registry} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service_registry: path.serviceRegistryName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Enable the default Service Registry {service_registry}.
        slots:
          service_registry: path.serviceRegistryName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/serviceRegistries/{serviceRegistryName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable the Service Registry
      effect: destructive
      questions:
      - How do I switch off the Service Registry on my instance?
      - Can I remove the default Service Registry?
      instructions:
      - text: Disable Service Registry {service_registry} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service_registry: path.serviceRegistryName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Delete Service Registry {service_registry}.
        slots:
          service_registry: path.serviceRegistryName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/serviceRegistries'].get
  update:
    x-apievangelist-phrasing:
      intent: List Service Registries in a service
      effect: read
      questions:
      - Is a Service Registry enabled anywhere in my Spring Apps service?
      - Can I list all Service Registry resources on an instance?
      instructions:
      - text: List the Service Registries on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all Service Registry resources in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationLiveViews'].get
  update:
    x-apievangelist-phrasing:
      intent: List Application Live View resources
      effect: read
      questions:
      - Is Application Live View set up on my Spring Apps service?
      - Can I list every Application Live View resource in an instance?
      instructions:
      - text: List the Application Live Views on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all Application Live View resources in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationLiveViews/{applicationLiveViewName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Application Live View
      effect: read
      questions:
      - What state is my Application Live View in?
      - How do I inspect a specific Application Live View resource?
      instructions:
      - text: Get Application Live View {live_view} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          live_view: path.applicationLiveViewName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the details of Application Live View {live_view}.
        slots:
          live_view: path.applicationLiveViewName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationLiveViews/{applicationLiveViewName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable or update Application Live View
      effect: write
      questions:
      - How do I enable Application Live View to watch my running apps?
      - Can I update the settings of an existing Application Live View?
      instructions:
      - text: Create Application Live View {live_view} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          live_view: path.applicationLiveViewName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update Application Live View {live_view} with {properties}.
        slots:
          live_view: path.applicationLiveViewName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationLiveViews/{applicationLiveViewName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable Application Live View
      effect: destructive
      questions:
      - How do I turn off Application Live View on my instance?
      - Can I remove the default Application Live View resource?
      instructions:
      - text: Disable Application Live View {live_view} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          live_view: path.applicationLiveViewName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Delete Application Live View {live_view}.
        slots:
          live_view: path.applicationLiveViewName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/DevToolPortals'].get
  update:
    x-apievangelist-phrasing:
      intent: List Dev Tool Portals
      effect: read
      questions:
      - Is a Dev Tool Portal configured on my Spring Apps service?
      - Can I list all Dev Tool Portal resources in an instance?
      instructions:
      - text: List the Dev Tool Portals on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all Dev Tool Portal resources in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/DevToolPortals/{devToolPortalName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Dev Tool Portal
      effect: read
      questions:
      - What settings does my Dev Tool Portal have?
      - How do I look at one Dev Tool Portal's configuration?
      instructions:
      - text: Get Dev Tool Portal {dev_portal} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          dev_portal: path.devToolPortalName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the details of Dev Tool Portal {dev_portal}.
        slots:
          dev_portal: path.devToolPortalName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/DevToolPortals/{devToolPortalName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable or update the Dev Tool Portal
      effect: write
      questions:
      - How do I turn on the Dev Tool Portal for my developers?
      - Can I change the settings of the Dev Tool Portal?
      instructions:
      - text: Create Dev Tool Portal {dev_portal} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          dev_portal: path.devToolPortalName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update Dev Tool Portal {dev_portal} with {properties}.
        slots:
          dev_portal: path.devToolPortalName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/DevToolPortals/{devToolPortalName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable the Dev Tool Portal
      effect: destructive
      questions:
      - How do I switch off the Dev Tool Portal?
      - Can I remove the default Dev Tool Portal from an instance?
      instructions:
      - text: Disable Dev Tool Portal {dev_portal} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          dev_portal: path.devToolPortalName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Delete Dev Tool Portal {dev_portal}.
        slots:
          dev_portal: path.devToolPortalName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/containerRegistries'].get
  update:
    x-apievangelist-phrasing:
      intent: List container registries linked to a service
      effect: read
      questions:
      - Which container registries are connected to my Spring Apps instance?
      - Can I see all registry credentials configured for image pulls?
      instructions:
      - text: List the image registries linked to service {service} (group {rg}, sub {sub}).
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every container registry linked to {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/containerRegistries/{containerRegistryName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a linked container registry
      effect: read
      questions:
      - How do I check the server and credential setup of one container registry?
      - What is the provisioning state of a container registry resource?
      instructions:
      - text: Fetch linked image registry {registry} from service {service} (group {rg}, sub {sub}).
        slots:
          registry: path.containerRegistryName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the details of container registry {registry}.
        slots:
          registry: path.containerRegistryName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/containerRegistries/{containerRegistryName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or update a container registry
      effect: write
      questions:
      - How do I connect a private container registry so my apps can pull images?
      - Can I update the credentials of a registry I already linked?
      instructions:
      - text: Add container registry {registry} to service {service} in resource group {rg}, subscription {sub}.
        slots:
          registry: path.containerRegistryName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update container registry {registry} with {properties}.
        slots:
          registry: path.containerRegistryName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/containerRegistries/{containerRegistryName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a container registry
      effect: destructive
      questions:
      - How do I unlink a container registry from my Spring Apps service?
      - Can I delete registry credentials I no longer need?
      instructions:
      - text: Delete container registry {registry} from service {service} in resource group {rg}, subscription {sub}.
        slots:
          registry: path.containerRegistryName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the container registry resource {registry}.
        slots:
          registry: path.containerRegistryName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/containerRegistries/{containerRegistryName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Check container registry credentials are valid
      effect: read
      questions:
      - Will my container registry credentials work before I save them?
      - How do I test registry credentials against my Spring Apps service?
      instructions:
      - text: Validate credentials {credentials} for container registry {registry} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          credentials: requestBody.credentials
          registry: path.containerRegistryName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check whether registry {registry} accepts credentials {credentials}.
        slots:
          registry: path.containerRegistryName
          credentials: requestBody.credentials
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices'].get
  update:
    x-apievangelist-phrasing:
      intent: List build services in a service
      effect: read
      questions:
      - Which build services exist on my Enterprise tier Spring Apps instance?
      - Can I list the build service resources that compile my source code?
      instructions:
      - text: List the build services on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all build service resources in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a build service
      effect: read
      questions:
      - What settings does my build service use?
      - Where can I see the provisioning state of a build service?
      instructions:
      - text: Get build service {build_service} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the configuration of build service {build_service}.
        slots:
          build_service: path.buildServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a build service
      effect: write
      questions:
      - Can I point my build service at my own container registry?
      - What does it take to set up a build service resource on an instance?
      instructions:
      - text: Create build service {build_service} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update build service {build_service} with {properties}.
        slots:
          build_service: path.buildServiceName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List KPack builds in a build service
      effect: read
      questions:
      - What KPack builds have been defined in my build service?
      - Can I see all the builds that exist under one build service?
      instructions:
      - text: List KPack builds in build service {build_service} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every build defined under build service {build_service}.
        slots:
          build_service: path.buildServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builds/{buildName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a KPack build
      effect: read
      questions:
      - What settings does a particular KPack build use?
      - Can I look up one build by name to check its latest result?
      instructions:
      - text: Look up the definition of KPack build {build} under {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          build: path.buildName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the definition of build {build}.
        slots:
          build: path.buildName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builds/{buildName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a KPack build
      effect: write
      questions:
      - How do I kick off a KPack build from an uploaded source archive?
      - Can I change the properties of an existing build definition?
      instructions:
      - text: Start a new KPack build named {build} under {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          build: path.buildName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update build {build} with properties {properties}.
        slots:
          build: path.buildName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builds/{buildName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a KPack build
      effect: destructive
      questions:
      - Can I clean up an old KPack build definition I don't need?
      - What removes a build from a build service?
      instructions:
      - text: Delete KPack build {build} from build service {build_service} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          build: path.buildName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the build named {build}.
        slots:
          build: path.buildName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildpackBindings'].get
  update:
    x-apievangelist-phrasing:
      intent: List buildpack bindings across all builders
      effect: read
      questions:
      - Which buildpack bindings exist across every builder on my Spring Apps instance?
      - Can I see all buildpack bindings service-wide in one call?
      instructions:
      - text: List buildpack bindings under all builders on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every buildpack binding across the whole of {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builders/{builderName}/buildpackBindings/{buildpackBindingName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a buildpack binding
      effect: read
      questions:
      - What properties does a specific buildpack binding have?
      - Can I inspect one binding on a builder by name?
      instructions:
      - text: Get buildpack binding {buildpack_binding} on builder {builder}, build service {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          buildpack_binding: path.buildpackBindingName
          builder: path.builderName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show buildpack binding {buildpack_binding} on builder {builder}.
        slots:
          buildpack_binding: path.buildpackBindingName
          builder: path.builderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builders/{builderName}/buildpackBindings/{buildpackBindingName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a buildpack binding
      effect: write
      questions:
      - How do I bind something like an APM agent to a builder's buildpacks?
      - Can I change the properties of an existing buildpack binding?
      instructions:
      - text: Create buildpack binding {buildpack_binding} on builder {builder}, build service {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          buildpack_binding: path.buildpackBindingName
          builder: path.builderName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update buildpack binding {buildpack_binding} with {properties}.
        slots:
          buildpack_binding: path.buildpackBindingName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builders/{builderName}/buildpackBindings/{buildpackBindingName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a buildpack binding
      effect: destructive
      questions:
      - Can I remove a buildpack binding from a builder?
      - What deletes an APM binding I added to my builder?
      instructions:
      - text: Delete buildpack binding {buildpack_binding} from builder {builder}, build service {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          buildpack_binding: path.buildpackBindingName
          builder: path.builderName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove buildpack binding {buildpack_binding}.
        slots:
          buildpack_binding: path.buildpackBindingName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builders/{builderName}/buildpackBindings'].get
  update:
    x-apievangelist-phrasing:
      intent: List buildpack bindings on one builder
      effect: read
      questions:
      - What buildpack bindings are attached to one particular builder?
      - Can I list only the bindings for a single builder?
      instructions:
      - text: List buildpack bindings on builder {builder} in build service {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          builder: path.builderName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the bindings attached to builder {builder}.
        slots:
          builder: path.builderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builds/{buildName}/results'].get
  update:
    x-apievangelist-phrasing:
      intent: List results of a KPack build
      effect: read
      questions:
      - Did my last KPack builds succeed or fail?
      - Can I see the history of results for one build?
      instructions:
      - text: List results of build {build} in build service {build_service} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          build: path.buildName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every run result for build {build}.
        slots:
          build: path.buildName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builds/{buildName}/results/{buildResultName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one KPack build result
      effect: read
      questions:
      - What was the status of a specific build run?
      - Can I look up one build result by name to see its provisioning state?
      instructions:
      - text: Get result {result} of build {build} in build service {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          result: path.buildResultName
          build: path.buildName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show build result {result} for build {build}.
        slots:
          result: path.buildResultName
          build: path.buildName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builds/{buildName}/results/{buildResultName}/getLogFileUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the log download URL for a build result
      effect: read
      questions:
      - Where can I download the logs of a failed KPack build run?
      - Is there a URL for the build log of one build result?
      instructions:
      - text: Get the log file URL for result {result} of build {build}, build service {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          result: path.buildResultName
          build: path.buildName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Give me a download link for the logs of build result {result}.
        slots:
          result: path.buildResultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builders/{builderName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a KPack builder
      effect: read
      questions:
      - What stack and buildpacks does one of my builders use?
      - Can I inspect a single builder by name?
      instructions:
      - text: Look up KPack builder {builder} under {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          builder: path.builderName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the stack and buildpacks of builder {builder}.
        slots:
          builder: path.builderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builders/{builderName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a KPack builder
      effect: write
      questions:
      - How do I define a custom builder with my own stack and buildpacks?
      - Can I change which buildpacks an existing builder includes?
      instructions:
      - text: Define a custom KPack builder {builder} under {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          builder: path.builderName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update builder {builder} with properties {properties}.
        slots:
          builder: path.builderName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builders/{builderName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a KPack builder
      effect: destructive
      questions:
      - Can I delete a custom builder I no longer need?
      - What removes a builder from my build service?
      instructions:
      - text: Delete builder {builder} from build service {build_service} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          builder: path.builderName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the builder named {builder}.
        slots:
          builder: path.builderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builders'].get
  update:
    x-apievangelist-phrasing:
      intent: List KPack builders in a build service
      effect: read
      questions:
      - Which builders are available in my build service?
      - Can I see every builder defined under one build service?
      instructions:
      - text: List builders in build service {build_service} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all builders under build service {build_service}.
        slots:
          build_service: path.buildServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/getResourceUploadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an upload URL for build service sources
      effect: read
      questions:
      - Where do I upload a source archive or artifact before starting a build?
      - Can I get an upload location for a build service rather than an app?
      instructions:
      - text: Get a resource upload URL for build service {build_service} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Give me an upload URL for sources to build in build service {build_service}.
        slots:
          build_service: path.buildServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/supportedBuildpacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List buildpacks supported by a build service
      effect: read
      questions:
      - Which buildpacks can I use in my build service?
      - Is there a list of every buildpack available to my builds?
      instructions:
      - text: List supported buildpacks for build service {build_service} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every buildpack build service {build_service} supports.
        slots:
          build_service: path.buildServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/supportedBuildpacks/{buildpackName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one supported buildpack
      effect: read
      questions:
      - What are the details of a specific supported buildpack?
      - Can I look up a single buildpack by name in my build service?
      instructions:
      - text: Get supported buildpack {buildpack} in build service {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          buildpack: path.buildpackName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show details of buildpack {buildpack}.
        slots:
          buildpack: path.buildpackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/supportedStacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List stacks supported by a build service
      effect: read
      questions:
      - Which OS stacks can my builders be based on?
      - Is there a list of supported stacks for my build service?
      instructions:
      - text: List supported stacks for build service {build_service} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the stacks build service {build_service} supports.
        slots:
          build_service: path.buildServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/supportedStacks/{stackName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one supported stack
      effect: read
      questions:
      - What are the details of a specific supported stack?
      - Is a specific OS stack available by name for my builders?
      instructions:
      - text: Get supported stack {stack} in build service {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          stack: path.stackName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show details of stack {stack}.
        slots:
          stack: path.stackName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/agentPools'].get
  update:
    x-apievangelist-phrasing:
      intent: List build agent pools
      effect: read
      questions:
      - Which agent pools run my builds, and how big are they?
      - Can I list the build agent pools under a build service?
      instructions:
      - text: List agent pools in build service {build_service} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the build agent pools of build service {build_service}.
        slots:
          build_service: path.buildServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/agentPools/{agentPoolName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a build agent pool
      effect: read
      questions:
      - What size is the agent pool that runs my builds?
      - Can I see the provisioning state of one build agent pool?
      instructions:
      - text: Get agent pool {pool} in build service {build_service} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          pool: path.agentPoolName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the size of build agent pool {pool}.
        slots:
          pool: path.agentPoolName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/agentPools/{agentPoolName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Resize or update a build agent pool
      effect: write
      questions:
      - Can I give my builds more capacity by updating the agent pool?
      - What does it take to scale up the build agent pool?
      instructions:
      - text: Update agent pool {pool} in build service {build_service} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          pool: path.agentPoolName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Set build agent pool {pool} properties to {properties}.
        slots:
          pool: path.agentPoolName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/monitoringSettings/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Get monitoring settings of a service
      effect: read
      questions:
      - Is tracing turned on for my Spring Apps service?
      - What monitoring and trace settings are configured on an instance?
      instructions:
      - text: Get the monitoring settings of service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show me the monitoring configuration of {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/monitoringSettings/default'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace monitoring settings of a service
      effect: write
      questions:
      - Can I overwrite the full monitoring configuration in one request?
      - What call resets all monitoring settings to a new payload?
      instructions:
      - text: Replace the monitoring settings on service {service} in resource group {rg}, subscription {sub} with {properties}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Overwrite all monitoring configuration of {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/monitoringSettings/default'].patch
  update:
    x-apievangelist-phrasing:
      intent: Partially update monitoring settings
      effect: write
      questions:
      - Can I change one monitoring setting without resending the whole config?
      - Is there a way to patch a single monitoring field?
      instructions:
      - text: Patch the monitoring settings on service {service} in resource group {rg}, subscription {sub} with {properties}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Change only the monitoring fields I give you on {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app and its properties
      effect: read
      questions:
      - What are the properties of one of my Spring apps?
      - Can I also see sync status when fetching an app?
      instructions:
      - text: Get app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show app {app} including sync status {syncStatus}.
        slots:
          app: path.appName
          syncStatus: query.syncStatus
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an app
      effect: write
      questions:
      - How do I create a new app inside my Spring Apps service?
      - Can I give an app a managed identity when I create it?
      instructions:
      - text: Create app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Create app {app} with managed identity {identity}.
        slots:
          app: path.appName
          identity: requestBody.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an app
      effect: destructive
      questions:
      - Does deleting an app also remove its deployments?
      - Can I delete an app I no longer run?
      instructions:
      - text: Delete app {app} from service {service} in resource group {rg}, subscription {sub}.
        slots:
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the app named {app} entirely.
        slots:
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch settings on an existing app
      effect: write
      questions:
      - Can I change the properties of an existing app without recreating it?
      - What changes the managed identity of an app that is already running?
      instructions:
      - text: Patch existing app {app} on service {service} in resource group {rg}, subscription {sub} with {properties}.
        slots:
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Change the identity of existing app {app} to {identity}.
        slots:
          app: path.appName
          identity: requestBody.identity
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps'].get
  update:
    x-apievangelist-phrasing:
      intent: List apps in a service
      effect: read
      questions:
      - Which apps are running in my Azure Spring Apps instance?
      - Can I get every app in a service in one list?
      instructions:
      - text: List the apps on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all apps in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/getResourceUploadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an upload URL for an app's artifact
      effect: read
      questions:
      - Where do I upload my JAR or source archive before deploying an app?
      - Can I get a storage URL to push an app artifact to?
      instructions:
      - text: Get a resource upload URL for app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Give me an upload URL for the JAR of app {app}.
        slots:
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/setActiveDeployments'].post
  update:
    x-apievangelist-phrasing:
      intent: Set the active deployment of an app
      effect: write
      questions:
      - How do I do a blue-green swap to make my staging deployment live?
      - Can I choose which deployment of an app receives production traffic?
      instructions:
      - text: Make deployments {activeDeploymentNames} active for app {app} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          activeDeploymentNames: requestBody.activeDeploymentNames
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Swap app {app} to active deployment {activeDeploymentNames}.
        slots:
          app: path.appName
          activeDeploymentNames: requestBody.activeDeploymentNames
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/bindings/{bindingName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's service binding
      effect: read
      questions:
      - What resource is a specific binding on my app connected to?
      - Can I look up one binding of an app by name?
      instructions:
      - text: Get binding {binding} of app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          binding: path.bindingName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show binding {binding} on app {app}.
        slots:
          binding: path.bindingName
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/bindings/{bindingName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or replace an app binding
      effect: write
      questions:
      - How do I bind a database or cache to my Spring app?
      - Can I create a binding that injects connection details into an app?
      instructions:
      - text: Create binding {binding} on app {app}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          binding: path.bindingName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Bind app {app} to a resource via new binding {binding} with {properties}.
        slots:
          app: path.appName
          binding: path.bindingName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/bindings/{bindingName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an app binding
      effect: destructive
      questions:
      - Can I unbind a resource from my app?
      - What removes a binding from a Spring app?
      instructions:
      - text: Delete binding {binding} from app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          binding: path.bindingName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove binding {binding} on app {app}.
        slots:
          binding: path.bindingName
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/bindings/{bindingName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an existing app binding
      effect: write
      questions:
      - Can I change the settings of a binding that already exists?
      - Is there a way to change only some fields of an app binding?
      instructions:
      - text: Patch existing binding {binding} on app {app}, service {service}, resource group {rg}, subscription {sub} with {properties}.
        slots:
          binding: path.bindingName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Update only the properties I pass on existing binding {binding}.
        slots:
          binding: path.bindingName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/bindings'].get
  update:
    x-apievangelist-phrasing:
      intent: List bindings on an app
      effect: read
      questions:
      - Which resources are bound to my app?
      - Can I list all bindings for one Spring app?
      instructions:
      - text: List the bindings of app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every binding on app {app}.
        slots:
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/storages/{storageName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a storage resource
      effect: read
      questions:
      - What are the details of one of my service's storage resources?
      - Can I inspect a single storage resource by name?
      instructions:
      - text: Get storage {storage} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          storage: path.storageName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the details of storage resource {storage}.
        slots:
          storage: path.storageName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/storages/{storageName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or update a storage resource
      effect: write
      questions:
      - How do I attach my own storage account so apps can mount persistent files?
      - Can I update a storage resource I already added?
      instructions:
      - text: Create storage {storage} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          storage: path.storageName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update storage resource {storage} with {properties}.
        slots:
          storage: path.storageName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/storages/{storageName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a storage resource
      effect: destructive
      questions:
      - Can I detach a storage resource from my Spring Apps service?
      - What removes a bring-your-own storage entry?
      instructions:
      - text: Delete storage {storage} from service {service} in resource group {rg}, subscription {sub}.
        slots:
          storage: path.storageName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove storage resource {storage}.
        slots:
          storage: path.storageName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/storages'].get
  update:
    x-apievangelist-phrasing:
      intent: List storage resources in a service
      effect: read
      questions:
      - What storage accounts are attached to my Spring Apps instance?
      - Can I list every storage resource in a service?
      instructions:
      - text: List the storages on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all storage resources in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/certificates/{certificateName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a certificate resource
      effect: read
      questions:
      - What are the details of a certificate I imported into my service?
      - Can I look up one certificate on my service by name?
      instructions:
      - text: Get certificate {certificate} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          certificate: path.certificateName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the properties of certificate {certificate}.
        slots:
          certificate: path.certificateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/certificates/{certificateName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Import or update a certificate
      effect: write
      questions:
      - How do I add a certificate to use with my custom domains?
      - Can I replace a certificate resource that already exists?
      instructions:
      - text: Import certificate {certificate} into service {service} in resource group {rg}, subscription {sub}.
        slots:
          certificate: path.certificateName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update certificate {certificate} with {properties}.
        slots:
          certificate: path.certificateName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/certificates/{certificateName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a certificate
      effect: destructive
      questions:
      - Can I remove a certificate I no longer use?
      - What deletes an imported TLS certificate from my service?
      instructions:
      - text: Delete certificate {certificate} from service {service} in resource group {rg}, subscription {sub}.
        slots:
          certificate: path.certificateName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the certificate named {certificate}.
        slots:
          certificate: path.certificateName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/certificates'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificates in a service
      effect: read
      questions:
      - Which TLS certificates have been imported into my Spring Apps instance?
      - Can I see all certificates on one service?
      instructions:
      - text: List the certificates on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every certificate in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AppPlatform/locations/{location}/checkNameAvailability'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a Spring Apps service name is free
      effect: read
      questions:
      - Is the service name I want already taken in this region?
      - Can I check a Spring Apps name is valid before creating it?
      instructions:
      - text: Check whether name {name} of type {type} is available in {location} for subscription {sub}.
        slots:
          name: requestBody.name
          type: requestBody.type
          location: path.location
          sub: path.subscriptionId
      - text: See if service name {name} is free in region {location}.
        slots:
          name: requestBody.name
          location: path.location
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/domains/{domainName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's custom domain
      effect: read
      questions:
      - What settings does one custom domain on my app have?
      - Can I inspect a single app custom domain by name?
      instructions:
      - text: Get custom domain {domain} of app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          domain: path.domainName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show custom domain {domain} on app {app}.
        slots:
          domain: path.domainName
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/domains/{domainName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or replace an app custom domain
      effect: write
      questions:
      - How do I map my own domain name to a Spring app?
      - Can I attach a certificate to a new custom domain on an app?
      instructions:
      - text: Add custom domain {domain} to app {app} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          domain: path.domainName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Map domain {domain} to app {app} with {properties}.
        slots:
          domain: path.domainName
          app: path.appName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/domains/{domainName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an app's custom domain
      effect: destructive
      questions:
      - Can I unmap a custom domain from my app?
      - What deletes a domain I no longer want pointing at a Spring app?
      instructions:
      - text: Delete custom domain {domain} from app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          domain: path.domainName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove domain {domain} from app {app}.
        slots:
          domain: path.domainName
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/domains/{domainName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an existing app custom domain
      effect: write
      questions:
      - Can I patch a custom domain that is already mapped to my app?
      - Can I edit a mapped domain's settings in place rather than re-adding it?
      instructions:
      - text: Patch existing custom domain {domain} of app {app} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          domain: path.domainName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Patch existing domain {domain} of app {app} with {properties}.
        slots:
          domain: path.domainName
          app: path.appName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom domains of an app
      effect: read
      questions:
      - Which custom domains point at my app?
      - Can I list every domain mapped to one Spring app?
      instructions:
      - text: List the custom domains of app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all domains on app {app}.
        slots:
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/validateDomain'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a domain can be mapped to an app
      effect: read
      questions:
      - Before mapping a domain to my app, can I check it is valid and not in use?
      - Why would my custom domain be rejected for an app?
      instructions:
      - text: Validate domain {name} for app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          name: requestBody.name
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check that domain {name} is free to use on app {app}.
        slots:
          name: requestBody.name
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app deployment
      effect: read
      questions:
      - What is the status of one deployment of my app?
      - Can I inspect a specific deployment like staging or green by name?
      instructions:
      - text: Get deployment {deployment} of app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployment {deployment} of app {app}.
        slots:
          deployment: path.deploymentName
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a Spring app deployment
      effect: write
      questions:
      - How do I roll out a new deployment for an app in Azure Spring Apps?
      - Can I change the SKU of an existing Spring app deployment?
      instructions:
      - text: Create deployment {deploymentName} for Spring app {appName} in service {serviceName}.
        slots:
          deploymentName: path.deploymentName
          appName: path.appName
          serviceName: path.serviceName
      - text: Update Spring app {appName} deployment {deploymentName} with properties {properties} and SKU {sku}.
        slots:
          appName: path.appName
          deploymentName: path.deploymentName
          properties: requestBody.properties
          sku: requestBody.sku
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an app deployment
      effect: destructive
      questions:
      - Can I delete an old staging deployment of my app?
      - What removes a deployment I no longer need?
      instructions:
      - text: Delete deployment {deployment} of app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove the deployment {deployment} from app {app}.
        slots:
          deployment: path.deploymentName
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an existing app deployment
      effect: write
      questions:
      - Can I scale instances or change settings of a deployment that already exists?
      - Is there a way to update only part of a running deployment?
      instructions:
      - text: Patch existing deployment {deployment} of app {app}, service {service}, resource group {rg}, subscription {sub} with {properties}.
        slots:
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          properties: requestBody.properties
      - text: Scale existing deployment {deployment} of app {app} to sku {sku}.
        slots:
          deployment: path.deploymentName
          app: path.appName
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployments of one app
      effect: read
      questions:
      - What deployments does my app have, and which version is each running?
      - Can I filter an app's deployments by version?
      instructions:
      - text: List the deployments of app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show deployments of app {app} running version {version}.
        slots:
          app: path.appName
          version: query.version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/deployments'].get
  update:
    x-apievangelist-phrasing:
      intent: List deployments across a whole service
      effect: read
      questions:
      - Which deployments exist across every app in my Spring Apps service?
      - Can I find all deployments on an instance that run a given version?
      instructions:
      - text: List all deployments across every app on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Find deployments on service {service} with version {version}.
        slots:
          service: path.serviceName
          version: query.version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices/{buildServiceName}/builders/{builderName}/listUsingDeployments'].post
  update:
    x-apievangelist-phrasing:
      intent: List deployments that use a builder
      effect: read
      questions:
      - Which deployments were built with a particular builder?
      - Is anything still using this builder before I delete it?
      instructions:
      - text: List deployments using builder {builder} in build service {build_service}, service {service}, group {rg}, sub {sub}.
        slots:
          builder: path.builderName
          build_service: path.buildServiceName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which deployments depend on builder {builder}.
        slots:
          builder: path.builderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a deployment
      effect: write
      questions:
      - How do I start a deployment that I stopped earlier?
      - Can I bring one deployment of an app back up without touching the others?
      instructions:
      - text: Start deployment {deployment} of app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Bring deployment {deployment} of app {app} back up.
        slots:
          deployment: path.deploymentName
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a deployment
      effect: write
      questions:
      - Can I stop a single deployment of my app to free resources?
      - What halts one deployment while the service keeps running?
      instructions:
      - text: Stop deployment {deployment} of app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Halt deployment {deployment} of app {app} for now.
        slots:
          deployment: path.deploymentName
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}/restart'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart a deployment
      effect: write
      questions:
      - My app is stuck - how do I restart just its deployment?
      - Can I bounce a deployment's instances without redeploying?
      instructions:
      - text: Restart deployment {deployment} of app {app} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Bounce deployment {deployment} of app {app}.
        slots:
          deployment: path.deploymentName
          app: path.appName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}/enableRemoteDebugging'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable remote debugging on a deployment
      effect: write
      questions:
      - How do I attach a remote debugger to a deployment of my app?
      - Can I choose which port remote debugging listens on?
      instructions:
      - text: Enable remote debugging on deployment {deployment} of app {app}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Turn on remote debugging for deployment {deployment} on port {port}.
        slots:
          deployment: path.deploymentName
          port: requestBody.port
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}/disableRemoteDebugging'].post
  update:
    x-apievangelist-phrasing:
      intent: Disable remote debugging on a deployment
      effect: write
      questions:
      - How do I turn remote debugging off again once I'm done?
      - Can I close the debug port on a deployment?
      instructions:
      - text: Disable remote debugging on deployment {deployment} of app {app}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Switch off the debugger on deployment {deployment}.
        slots:
          deployment: path.deploymentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}/getRemoteDebuggingConfig'].post
  update:
    x-apievangelist-phrasing:
      intent: Get remote debugging config of a deployment
      effect: read
      questions:
      - Is remote debugging currently enabled on my deployment, and on which port?
      - Where can I check the debug settings of a deployment?
      instructions:
      - text: Get the remote debugging config of deployment {deployment}, app {app}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Tell me whether deployment {deployment} has remote debugging on.
        slots:
          deployment: path.deploymentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}/getLogFileUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the log file URL of a deployment
      effect: read
      questions:
      - Where can I download the log file for one deployment of my app?
      - Is there a URL to fetch a deployment's logs?
      instructions:
      - text: Get the log file URL for deployment {deployment} of app {app} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Give me a link to the logs of deployment {deployment}.
        slots:
          deployment: path.deploymentName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}/generateHeapDump'].post
  update:
    x-apievangelist-phrasing:
      intent: Capture a heap dump from an app instance
      effect: write
      questions:
      - How do I capture a Java heap dump from one instance of my app?
      - Can I write a heap dump to a file path in my own storage?
      instructions:
      - text: Generate a heap dump of instance {appInstance} in deployment {deployment}, app {app}, service {service}, group {rg}, sub {sub}.
        slots:
          appInstance: requestBody.appInstance
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Take a heap dump of {appInstance} and save it to {filePath}.
        slots:
          appInstance: requestBody.appInstance
          filePath: requestBody.filePath
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}/generateThreadDump'].post
  update:
    x-apievangelist-phrasing:
      intent: Capture a thread dump from an app instance
      effect: write
      questions:
      - My app seems deadlocked - can I grab a thread dump from one instance?
      - Which instance and file path do I need to capture a thread dump?
      instructions:
      - text: Generate a thread dump of instance {appInstance} in deployment {deployment}, app {app}, service {service}, group {rg}, sub {sub}.
        slots:
          appInstance: requestBody.appInstance
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Dump the threads of {appInstance} to file {filePath}.
        slots:
          appInstance: requestBody.appInstance
          filePath: requestBody.filePath
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apps/{appName}/deployments/{deploymentName}/startJFR'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a Java Flight Recorder capture
      effect: write
      questions:
      - How do I record a Java Flight Recorder profile of one app instance?
      - Can I set how long a JFR recording runs, like 60s or 5m?
      instructions:
      - text: Start JFR on instance {appInstance} in deployment {deployment}, app {app}, service {service}, group {rg}, sub {sub}.
        slots:
          appInstance: requestBody.appInstance
          deployment: path.deploymentName
          app: path.appName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Record JFR on {appInstance} for {duration} and save to {filePath}.
        slots:
          appInstance: requestBody.appInstance
          duration: requestBody.duration
          filePath: requestBody.filePath
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AppPlatform/Spring'].get
  update:
    x-apievangelist-phrasing:
      intent: List all Spring Apps services in a subscription
      effect: read
      questions:
      - What Spring Apps instances do I have across my whole subscription?
      - Can I see every service instance regardless of resource group?
      instructions:
      - text: List all Spring Apps services in subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show every service instance across subscription {sub}.
        slots:
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring'].get
  update:
    x-apievangelist-phrasing:
      intent: List Spring Apps services in a resource group
      effect: read
      questions:
      - Which Spring Apps instances live in one resource group?
      - Can I narrow the service list to a single resource group?
      instructions:
      - text: List Spring Apps services in resource group {rg}, subscription {sub}.
        slots:
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the service instances inside resource group {rg}.
        slots:
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.AppPlatform/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List the Microsoft.AppPlatform REST operations
      effect: read
      questions:
      - What REST operations does the Microsoft.AppPlatform provider expose?
      - Is there a catalog of every action I can grant permissions on for Spring Apps?
      instructions:
      - text: List all available Microsoft.AppPlatform operations for API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Show me the provider's operation catalog.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.AppPlatform/runtimeVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported runtime versions
      effect: read
      questions:
      - Which runtime versions can my apps run on?
      - Is a given runtime version supported by the platform?
      instructions:
      - text: List the runtime versions the AppPlatform provider supports under API version {api_version}.
        slots:
          api_version: query.api-version
      - text: Show all supported runtime versions.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.AppPlatform/skus'].get
  update:
    x-apievangelist-phrasing:
      intent: List available Spring Apps SKUs
      effect: read
      questions:
      - Which tiers and SKUs are offered for Spring Apps?
      - Can I check available SKUs before creating an instance?
      instructions:
      - text: List the available AppPlatform SKUs for subscription {sub}.
        slots:
          sub: path.subscriptionId
      - text: Show every SKU I can pick for a new instance in subscription {sub}.
        slots:
          sub: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/supportedServerVersions'].get
  update:
    x-apievangelist-phrasing:
      intent: List server versions a service supports
      effect: read
      questions:
      - Which server versions can deployments on my service use?
      - What server versions does one instance support?
      instructions:
      - text: List the supported server versions for service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show which server versions {service} supports.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the Spring Cloud Gateway
      effect: read
      questions:
      - What settings does my Spring Cloud Gateway have?
      - Can I check the provisioning state of a gateway by name?
      instructions:
      - text: Get Spring Cloud Gateway {gateway} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the configuration of gateway {gateway}.
        slots:
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable or update the Spring Cloud Gateway
      effect: write
      questions:
      - How do I turn on Spring Cloud Gateway for my Enterprise instance?
      - Can I set both gateway properties and its SKU in one request?
      instructions:
      - text: Create Spring Cloud Gateway {gateway} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update gateway {gateway} with {properties} on sku {sku}.
        slots:
          gateway: path.gatewayName
          properties: requestBody.properties
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable the Spring Cloud Gateway
      effect: destructive
      questions:
      - How do I switch off Spring Cloud Gateway on my instance?
      - Can I remove the default gateway entirely?
      instructions:
      - text: Disable Spring Cloud Gateway {gateway} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Delete the gateway {gateway}.
        slots:
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Scale the Spring Cloud Gateway capacity
      effect: write
      questions:
      - Can I add more gateway instances without touching its other settings?
      - What changes only the capacity of my Spring Cloud Gateway?
      instructions:
      - text: Scale gateway {gateway} on service {service}, resource group {rg}, subscription {sub} to sku {sku}.
        slots:
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
          sku: requestBody.sku
      - text: Change only the capacity of gateway {gateway} to {sku}.
        slots:
          gateway: path.gatewayName
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}/listEnvSecrets'].post
  update:
    x-apievangelist-phrasing:
      intent: Reveal the gateway's secret environment variables
      effect: read
      questions:
      - Where can I read the sensitive environment variables set on my gateway?
      - Can I list the secret env vars of Spring Cloud Gateway?
      instructions:
      - text: List the secret environment variables of gateway {gateway} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Reveal the sensitive env vars on gateway {gateway}.
        slots:
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}/restart'].post
  update:
    x-apievangelist-phrasing:
      intent: Restart the Spring Cloud Gateway
      effect: write
      questions:
      - My gateway is misbehaving - can I restart it?
      - Is there a way to bounce Spring Cloud Gateway without redeploying apps?
      instructions:
      - text: Restart gateway {gateway} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Bounce Spring Cloud Gateway {gateway}.
        slots:
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways'].get
  update:
    x-apievangelist-phrasing:
      intent: List Spring Cloud Gateways in a service
      effect: read
      questions:
      - Is Spring Cloud Gateway enabled on my Spring Apps service?
      - Can I list every gateway resource in an instance?
      instructions:
      - text: List the Spring Cloud Gateways on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all gateway resources in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}/routeConfigs/{routeConfigName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a gateway route config
      effect: read
      questions:
      - Which routes does one gateway route config define?
      - Can I inspect a single route configuration by name?
      instructions:
      - text: Get route config {route_config} on gateway {gateway}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          route_config: path.routeConfigName
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show route config {route_config} of gateway {gateway}.
        slots:
          route_config: path.routeConfigName
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}/routeConfigs/{routeConfigName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a gateway route config
      effect: write
      questions:
      - How do I route a path on Spring Cloud Gateway to one of my apps?
      - Can I change the routes of an existing route config?
      instructions:
      - text: Create route config {route_config} on gateway {gateway}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          route_config: path.routeConfigName
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update gateway route config {route_config} with {properties}.
        slots:
          route_config: path.routeConfigName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}/routeConfigs/{routeConfigName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a gateway route config
      effect: destructive
      questions:
      - Can I remove a set of routes from my gateway?
      - What deletes a route config I no longer need?
      instructions:
      - text: Delete route config {route_config} from gateway {gateway}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          route_config: path.routeConfigName
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove gateway route config {route_config}.
        slots:
          route_config: path.routeConfigName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}/routeConfigs'].get
  update:
    x-apievangelist-phrasing:
      intent: List a gateway's route configs
      effect: read
      questions:
      - What route configs are defined on my Spring Cloud Gateway?
      - Can I list every route configuration on one gateway?
      instructions:
      - text: List route configs on gateway {gateway}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all route configs of gateway {gateway}.
        slots:
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}/domains/{domainName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a gateway custom domain
      effect: read
      questions:
      - What settings does a custom domain on my gateway have?
      - Can I look up one gateway domain by name?
      instructions:
      - text: Get custom domain {domain} of gateway {gateway}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          domain: path.domainName
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show gateway {gateway} domain {domain}.
        slots:
          gateway: path.gatewayName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}/domains/{domainName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or update a gateway custom domain
      effect: write
      questions:
      - How do I put my own domain in front of Spring Cloud Gateway?
      - Can I change the certificate used by a gateway custom domain?
      instructions:
      - text: Add custom domain {domain} to gateway {gateway}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          domain: path.domainName
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update gateway domain {domain} with {properties}.
        slots:
          domain: path.domainName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}/domains/{domainName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a gateway custom domain
      effect: destructive
      questions:
      - Can I unmap a custom domain from my gateway?
      - What removes a domain from Spring Cloud Gateway?
      instructions:
      - text: Delete custom domain {domain} from gateway {gateway}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          domain: path.domainName
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Unmap domain {domain} from gateway {gateway}.
        slots:
          domain: path.domainName
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List a gateway's custom domains
      effect: read
      questions:
      - Which custom domains point at my Spring Cloud Gateway?
      - Can I list every domain mapped to one gateway?
      instructions:
      - text: List custom domains of gateway {gateway}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all domains mapped to gateway {gateway}.
        slots:
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/gateways/{gatewayName}/validateDomain'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a domain can be mapped to the gateway
      effect: read
      questions:
      - Before adding a domain to my gateway, can I check it is valid and unused?
      - Why might a gateway custom domain be rejected?
      instructions:
      - text: Validate domain {name} for gateway {gateway} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          name: requestBody.name
          gateway: path.gatewayName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check that {name} is free to map to gateway {gateway}.
        slots:
          name: requestBody.name
          gateway: path.gatewayName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apiPortals/{apiPortalName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the API portal
      effect: read
      questions:
      - What settings does my API portal have?
      - Can I check the state of the API portal on my instance?
      instructions:
      - text: Get API portal {portal} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          portal: path.apiPortalName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the configuration of API portal {portal}.
        slots:
          portal: path.apiPortalName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apiPortals/{apiPortalName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable or update the API portal
      effect: write
      questions:
      - How do I publish an API portal so developers can browse my gateway APIs?
      - Can I set the API portal SKU and properties together?
      instructions:
      - text: Create API portal {portal} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          portal: path.apiPortalName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update API portal {portal} with {properties} on sku {sku}.
        slots:
          portal: path.apiPortalName
          properties: requestBody.properties
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apiPortals/{apiPortalName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete the API portal
      effect: destructive
      questions:
      - How do I remove the API portal from my Spring Apps instance?
      - Can I take the default API portal down?
      instructions:
      - text: Delete API portal {portal} from service {service} in resource group {rg}, subscription {sub}.
        slots:
          portal: path.apiPortalName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Take down API portal {portal}.
        slots:
          portal: path.apiPortalName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apiPortals'].get
  update:
    x-apievangelist-phrasing:
      intent: List API portals in a service
      effect: read
      questions:
      - Is an API portal set up on my Spring Apps service?
      - Can I list every API portal resource in an instance?
      instructions:
      - text: List the API portals on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all API portal resources in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apiPortals/{apiPortalName}/domains/{domainName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an API portal custom domain
      effect: read
      questions:
      - What settings does one of my API portal domains have?
      - Can I look up a single API portal domain by name?
      instructions:
      - text: Get custom domain {domain} of API portal {portal}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          domain: path.domainName
          portal: path.apiPortalName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show API portal {portal} domain {domain}.
        slots:
          portal: path.apiPortalName
          domain: path.domainName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apiPortals/{apiPortalName}/domains/{domainName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or update an API portal custom domain
      effect: write
      questions:
      - How do I serve my API portal from my own domain name?
      - Can I change the certificate on an API portal domain?
      instructions:
      - text: Add custom domain {domain} to API portal {portal}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          domain: path.domainName
          portal: path.apiPortalName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update API portal domain {domain} with {properties}.
        slots:
          domain: path.domainName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apiPortals/{apiPortalName}/domains/{domainName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an API portal custom domain
      effect: destructive
      questions:
      - Can I unmap a custom domain from the API portal?
      - What removes a domain from my API portal?
      instructions:
      - text: Delete custom domain {domain} from API portal {portal}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          domain: path.domainName
          portal: path.apiPortalName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Unmap domain {domain} from API portal {portal}.
        slots:
          domain: path.domainName
          portal: path.apiPortalName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apiPortals/{apiPortalName}/domains'].get
  update:
    x-apievangelist-phrasing:
      intent: List an API portal's custom domains
      effect: read
      questions:
      - Which custom domains point at my API portal?
      - Can I list every domain mapped to the API portal?
      instructions:
      - text: List custom domains of API portal {portal}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          portal: path.apiPortalName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all domains on API portal {portal}.
        slots:
          portal: path.apiPortalName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/apiPortals/{apiPortalName}/validateDomain'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a domain can be mapped to the API portal
      effect: read
      questions:
      - Before adding a domain to my API portal, can I check it is valid and unused?
      - Why might an API portal custom domain be rejected?
      instructions:
      - text: Validate domain {name} for API portal {portal} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          name: requestBody.name
          portal: path.apiPortalName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check that {name} is free to map to API portal {portal}.
        slots:
          name: requestBody.name
          portal: path.apiPortalName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators'].get
  update:
    x-apievangelist-phrasing:
      intent: List Application Accelerators
      effect: read
      questions:
      - Is Application Accelerator enabled on my Spring Apps service?
      - Can I list every application accelerator resource in an instance?
      instructions:
      - text: List application accelerators on service {service} in resource group {rg}, subscription {sub}.
        slots:
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all Application Accelerator resources in {service}.
        slots:
          service: path.serviceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators/{applicationAcceleratorName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Application Accelerator
      effect: read
      questions:
      - What state is my Application Accelerator in?
      - Can I inspect one application accelerator by name?
      instructions:
      - text: Get application accelerator {accelerator} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          accelerator: path.applicationAcceleratorName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the details of Application Accelerator {accelerator}.
        slots:
          accelerator: path.applicationAcceleratorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators/{applicationAcceleratorName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Enable or update Application Accelerator
      effect: write
      questions:
      - How do I turn on Application Accelerator so teams can scaffold projects from templates?
      - Can I set the SKU when enabling Application Accelerator?
      instructions:
      - text: Create application accelerator {accelerator} on service {service} in resource group {rg}, subscription {sub}.
        slots:
          accelerator: path.applicationAcceleratorName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update Application Accelerator {accelerator} with {properties} on sku {sku}.
        slots:
          accelerator: path.applicationAcceleratorName
          properties: requestBody.properties
          sku: requestBody.sku
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators/{applicationAcceleratorName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Application Accelerator
      effect: destructive
      questions:
      - Can I switch off Application Accelerator on my instance?
      - What removes the application accelerator resource?
      instructions:
      - text: Delete application accelerator {accelerator} from service {service} in resource group {rg}, subscription {sub}.
        slots:
          accelerator: path.applicationAcceleratorName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove Application Accelerator {accelerator}.
        slots:
          accelerator: path.applicationAcceleratorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators/{applicationAcceleratorName}/customizedAccelerators'].get
  update:
    x-apievangelist-phrasing:
      intent: List customized accelerators
      effect: read
      questions:
      - Which custom project templates have we added to Application Accelerator?
      - Can I list all customized accelerators under one accelerator?
      instructions:
      - text: List customized accelerators in {accelerator} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          accelerator: path.applicationAcceleratorName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all custom accelerators under Application Accelerator {accelerator}.
        slots:
          accelerator: path.applicationAcceleratorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators/{applicationAcceleratorName}/customizedAccelerators/{customizedAcceleratorName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a customized accelerator
      effect: read
      questions:
      - What settings does one of our custom accelerators use?
      - Can I inspect a single customized accelerator by name?
      instructions:
      - text: Get customized accelerator {customized} in {accelerator}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          customized: path.customizedAcceleratorName
          accelerator: path.applicationAcceleratorName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show custom accelerator {customized}.
        slots:
          customized: path.customizedAcceleratorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators/{applicationAcceleratorName}/customizedAccelerators/{customizedAcceleratorName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a customized accelerator
      effect: write
      questions:
      - How do I add my own git-hosted project template as an accelerator?
      - Can I change the repository behind a custom accelerator I already added?
      instructions:
      - text: Create customized accelerator {customized} in {accelerator}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          customized: path.customizedAcceleratorName
          accelerator: path.applicationAcceleratorName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update custom accelerator {customized} with {properties}.
        slots:
          customized: path.customizedAcceleratorName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators/{applicationAcceleratorName}/customizedAccelerators/{customizedAcceleratorName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a customized accelerator
      effect: destructive
      questions:
      - Can I remove a custom project template from Application Accelerator?
      - What deletes a customized accelerator?
      instructions:
      - text: Delete customized accelerator {customized} from {accelerator}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          customized: path.customizedAcceleratorName
          accelerator: path.applicationAcceleratorName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove custom accelerator {customized}.
        slots:
          customized: path.customizedAcceleratorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators/{applicationAcceleratorName}/customizedAccelerators/{customizedAcceleratorName}/validate'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a customized accelerator's git repo is valid
      effect: read
      questions:
      - Will the git repository for my custom accelerator be accepted before I save it?
      - How can I test a customized accelerator definition for errors?
      instructions:
      - text: Validate custom accelerator {customized} in {accelerator} with git repo {gitRepository}, service {service}, group {rg}, sub {sub}.
        slots:
          customized: path.customizedAcceleratorName
          accelerator: path.applicationAcceleratorName
          gitRepository: requestBody.gitRepository
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check git repository {gitRepository} works for custom accelerator {customized}.
        slots:
          gitRepository: requestBody.gitRepository
          customized: path.customizedAcceleratorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators/{applicationAcceleratorName}/predefinedAccelerators'].get
  update:
    x-apievangelist-phrasing:
      intent: List predefined accelerators
      effect: read
      questions:
      - Which built-in project templates ship with Application Accelerator?
      - Can I see all predefined accelerators and whether each is enabled?
      instructions:
      - text: List predefined accelerators in {accelerator} on service {service}, resource group {rg}, subscription {sub}.
        slots:
          accelerator: path.applicationAcceleratorName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show the built-in accelerators under {accelerator}.
        slots:
          accelerator: path.applicationAcceleratorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators/{applicationAcceleratorName}/predefinedAccelerators/{predefinedAcceleratorName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a predefined accelerator
      effect: read
      questions:
      - What does one built-in accelerator template contain, and is it enabled?
      - Can I look up a single predefined accelerator by name?
      instructions:
      - text: Get predefined accelerator {predefined} in {accelerator}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          predefined: path.predefinedAcceleratorName
          accelerator: path.applicationAcceleratorName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show built-in accelerator {predefined}.
        slots:
          predefined: path.predefinedAcceleratorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators/{applicationAcceleratorName}/predefinedAccelerators/{predefinedAcceleratorName}/disable'].post
  update:
    x-apievangelist-phrasing:
      intent: Disable a predefined accelerator
      effect: write
      questions:
      - Can I hide a built-in accelerator template from my developers?
      - What switches off one predefined accelerator?
      instructions:
      - text: Disable predefined accelerator {predefined} in {accelerator}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          predefined: path.predefinedAcceleratorName
          accelerator: path.applicationAcceleratorName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Turn off built-in accelerator {predefined}.
        slots:
          predefined: path.predefinedAcceleratorName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/applicationAccelerators/{applicationAcceleratorName}/predefinedAccelerators/{predefinedAcceleratorName}/enable'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable a predefined accelerator
      effect: write
      questions:
      - Can I turn a built-in accelerator template back on?
      - What re-enables a predefined accelerator I disabled?
      instructions:
      - text: Enable predefined accelerator {predefined} in {accelerator}, service {service}, resource group {rg}, subscription {sub}.
        slots:
          predefined: path.predefinedAcceleratorName
          accelerator: path.applicationAcceleratorName
          service: path.serviceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Turn built-in accelerator {predefined} back on.
        slots:
          predefined: path.predefinedAcceleratorName
      method: generated
      generated: '2026-09-26'