# 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 Provider Registration API
  version: 1.0.0
extends: openapi/microsoft-azure-providerregistration-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: 5
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a resource provider registration
      effect: read
      questions:
      - How do I see the registration details for my resource provider namespace?
      - What does a ProviderHub provider registration contain?
      instructions:
      - text: Get the provider registration for namespace {namespace}.
        slots:
          namespace: path.providerNamespace
      - text: Show ProviderHub registration details of {namespace}.
        slots:
          namespace: path.providerNamespace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a resource provider registration
      effect: write
      questions:
      - Can I register a new resource provider namespace through ProviderHub?
      - Is it possible to update an existing provider registration's properties?
      instructions:
      - text: Create provider registration {namespace} with properties {properties}.
        slots:
          namespace: path.providerNamespace
          properties: requestBody.properties
      - text: Register resource provider namespace {namespace} in ProviderHub.
        slots:
          namespace: path.providerNamespace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a resource provider registration
      effect: destructive
      questions:
      - How do I delete a provider registration I no longer need?
      - Can I unregister a resource provider namespace from ProviderHub?
      instructions:
      - text: Delete the provider registration for namespace {namespace}.
        slots:
          namespace: path.providerNamespace
      - text: Remove ProviderHub registration {namespace}.
        slots:
          namespace: path.providerNamespace
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations'].get
  update:
    x-apievangelist-phrasing:
      intent: List provider registrations in a subscription
      effect: read
      questions:
      - Which provider registrations exist in my subscription?
      - Can I list every ProviderHub namespace registered in one subscription?
      instructions:
      - text: List the provider registrations in my subscription.
      - text: Show every ProviderHub provider registration I have.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.ProviderHub/providerRegistrations/{providerNamespace}/generateOperations'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate the operations API for a provider
      effect: write
      questions:
      - How do I generate the operations API for my resource provider?
      - Can ProviderHub build the operations listing for a namespace automatically?
      instructions:
      - text: Generate the operations API for provider namespace {namespace}.
        slots:
          namespace: path.providerNamespace
      - text: Build the operations endpoint for {namespace}.
        slots:
          namespace: path.providerNamespace
      method: generated
      generated: '2026-09-26'