# 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 ProviderHub Custom Rollouts API
  version: 1.0.0
extends: openapi/microsoft-azure-customrollouts-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 3
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/customRollouts/{rolloutName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a custom rollout
      effect: read
      questions:
      - How do I check the details of a custom rollout for my resource provider?
      - What's the current status of a ProviderHub custom rollout?
      instructions:
      - text: Show custom rollout {rolloutName} for provider {providerNamespace}.
        slots:
          rolloutName: path.rolloutName
          providerNamespace: path.providerNamespace
      - text: Get the status of rollout {rolloutName} in {providerNamespace}.
        slots:
          rolloutName: path.rolloutName
          providerNamespace: path.providerNamespace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/customRollouts/{rolloutName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a custom rollout
      effect: write
      questions:
      - How do I start a custom rollout for my resource provider registration?
      - Can I change a custom rollout's properties after creating it?
      instructions:
      - text: Create custom rollout {rolloutName} for {providerNamespace} with properties {properties}.
        slots:
          rolloutName: path.rolloutName
          providerNamespace: path.providerNamespace
          properties: requestBody.properties
      - text: Update custom rollout {rolloutName} in {providerNamespace}.
        slots:
          rolloutName: path.rolloutName
          providerNamespace: path.providerNamespace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/customRollouts'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom rollouts for a provider
      effect: read
      questions:
      - Which custom rollouts exist for my provider registration?
      - Can I see every rollout for one provider namespace?
      instructions:
      - text: List custom rollouts for provider {providerNamespace}.
        slots:
          providerNamespace: path.providerNamespace
      - text: Show all rollouts registered under {providerNamespace}.
        slots:
          providerNamespace: path.providerNamespace
      method: generated
      generated: '2026-09-26'