# 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 API Client App Service Certificate Orders…
  version: 1.0.0
extends: openapi/microsoft-azure-appservicecertificateorders-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: 20
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.CertificateRegistration/certificateOrders'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificate orders across a subscription
      effect: read
      questions:
      - Which App Service certificate orders exist across my whole Azure subscription?
      - Can I see every SSL certificate purchase order in one subscription, regardless of resource group?
      instructions:
      - text: List all App Service certificate orders in subscription {subscription}.
        slots:
          subscription: path.subscriptionId
      - text: Show every certificate purchase order under subscription {subscription}, across all resource groups.
        slots:
          subscription: path.subscriptionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.CertificateRegistration/validateCertificateRegistrationInformation'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a certificate purchase before ordering
      effect: read
      questions:
      - Can I check that my App Service certificate order details are valid before I buy?
      - What does Azure need to validate a certificate purchase request?
      instructions:
      - text: Validate a certificate purchase in subscription {subscriptionId} before placing the order.
        slots:
          subscriptionId: path.subscriptionId
      - text: Check certificate order details {properties} in subscription {subscriptionId} without buying.
        slots:
          subscriptionId: path.subscriptionId
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificate orders in a resource group
      effect: read
      questions:
      - Which certificate orders live in one specific resource group?
      - Is there a way to see only the certificate orders scoped to a single resource group?
      instructions:
      - text: List certificate orders in resource group {resource_group} of subscription {subscription}.
        slots:
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the App Service certificate orders that belong to resource group {resource_group}.
        slots:
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one certificate order
      effect: read
      questions:
      - How do I look up the status and details of a single certificate order?
      - What does one App Service certificate order record contain when I fetch it by name?
      instructions:
      - text: Get certificate order {order} in resource group {resource_group}, subscription {subscription}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show me the details of the {order} certificate order in {resource_group}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Place or replace a certificate purchase order
      effect: write
      questions:
      - Can I buy a new App Service certificate through the API?
      - Will putting a certificate order with an existing name overwrite the whole order?
      instructions:
      - text: Create certificate purchase order {order} in resource group {resource_group} under subscription {subscription}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Place a new certificate order named {order} in {resource_group} with properties {properties}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a certificate order
      effect: destructive
      questions:
      - How do I remove a certificate order I no longer need?
      - What do I need to identify a certificate order in order to delete it?
      instructions:
      - text: Delete certificate order {order} from resource group {resource_group} in subscription {subscription}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove the {order} certificate order entirely.
        slots:
          order: path.certificateOrderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch an existing certificate order
      effect: write
      questions:
      - Can I change just a few settings on a certificate order that already exists?
      - Is there a partial-update call for a certificate order so I don't resend the full definition?
      instructions:
      - text: Patch the existing certificate order {order} in {resource_group} (subscription {subscription}) with {properties}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
          properties: requestBody.properties
      - text: Update only the changed fields of certificate order {order}.
        slots:
          order: path.certificateOrderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificates attached to a certificate order
      effect: read
      questions:
      - Which certificates are attached to my certificate order?
      - Can I list the Key Vault-bound certificates under one order?
      instructions:
      - text: List the certificates associated with certificate order {order} in {resource_group}, subscription {subscription}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show all certificates stored under order {order}.
        slots:
          order: path.certificateOrderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one certificate from a certificate order
      effect: read
      questions:
      - What Key Vault secret is a given order certificate linked to?
      - Can I fetch one specific certificate binding from a certificate order by name?
      instructions:
      - text: Get certificate {certificate} from certificate order {order} in {resource_group} (subscription {subscription}).
        slots:
          certificate: path.name
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show the {certificate} certificate on order {order}.
        slots:
          certificate: path.name
          order: path.certificateOrderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}'].put
  update:
    x-apievangelist-phrasing:
      intent: Link a Key Vault secret to a certificate order
      effect: write
      questions:
      - How do I tell a certificate order which Key Vault secret should store the issued certificate?
      - Can I associate a Key Vault secret with my certificate order before it is ready?
      instructions:
      - text: Associate Key Vault secret certificate {name} with order {certificateOrderName} using {properties}.
        slots:
          name: path.name
          certificateOrderName: path.certificateOrderName
          properties: requestBody.properties
      - text: Create certificate store binding {name} on order {certificateOrderName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          name: path.name
          certificateOrderName: path.certificateOrderName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a certificate from a certificate order
      effect: destructive
      questions:
      - Can I detach a Key Vault-linked certificate from an order without deleting the order itself?
      - What is needed to delete one certificate under a certificate order?
      instructions:
      - text: Delete certificate {certificate} from certificate order {order} in {resource_group}, subscription {subscription}.
        slots:
          certificate: path.name
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Remove the {certificate} certificate binding from order {order}.
        slots:
          certificate: path.name
          order: path.certificateOrderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/certificates/{name}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Patch a certificate order's Key Vault binding
      effect: write
      questions:
      - Can I patch the Key Vault secret binding on an existing certificate order certificate?
      - What changes the secret an order's certificate is stored in after setup?
      instructions:
      - text: Patch certificate {name} on order {certificateOrderName} with properties {properties}.
        slots:
          name: path.name
          certificateOrderName: path.certificateOrderName
          properties: requestBody.properties
      - text: Change the existing Key Vault binding {name} for order {certificateOrderName} in {resourceGroupName} of subscription {subscriptionId}.
        slots:
          name: path.name
          certificateOrderName: path.certificateOrderName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/reissue'].post
  update:
    x-apievangelist-phrasing:
      intent: Reissue a certificate from an existing order
      effect: write
      questions:
      - How do I get a certificate reissued from an order I already own?
      - Can I pass reissue options when requesting a new copy of my certificate?
      instructions:
      - text: Reissue certificate order {order} in {resource_group}, subscription {subscription}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Reissue order {order} using reissue options {options}.
        slots:
          order: path.certificateOrderName
          options: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/renew'].post
  update:
    x-apievangelist-phrasing:
      intent: Renew an existing certificate order
      effect: write
      questions:
      - Can I renew an App Service certificate before it expires?
      - Is it possible to trigger renewal of a certificate order manually rather than waiting?
      instructions:
      - text: Renew certificate order {order} in {resource_group}, subscription {subscription}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Renew order {order} with renewal settings {settings}.
        slots:
          order: path.certificateOrderName
          settings: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/resendEmail'].post
  update:
    x-apievangelist-phrasing:
      intent: Resend the certificate email
      effect: write
      questions:
      - I lost the certificate email for my order - can it be sent again?
      - Where do I trigger a resend of the issued certificate email?
      instructions:
      - text: Resend the certificate email for order {order} in {resource_group}, subscription {subscription}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Send the certificate email for {order} one more time.
        slots:
          order: path.certificateOrderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/resendRequestEmails'].post
  update:
    x-apievangelist-phrasing:
      intent: Resend the domain verification email
      effect: write
      questions:
      - The domain verification email for my certificate order never arrived - can I have it resent?
      - How do I get the domain ownership verification steps emailed again?
      instructions:
      - text: Resend the domain verification email for certificate order {order} in {resource_group}, subscription {subscription}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Email the domain ownership verification instructions for order {order} again.
        slots:
          order: path.certificateOrderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/retrieveSiteSeal'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the site seal for an issued certificate
      effect: read
      questions:
      - Can I get a site seal graphic to embed on my website for an issued certificate?
      - Does the site seal come in a light theme or a specific locale?
      instructions:
      - text: Get the site seal for certificate order {order} in {resource_group}, subscription {subscription}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Retrieve the site seal for order {order} with light theme {light_theme} and locale {locale}.
        slots:
          order: path.certificateOrderName
          light_theme: requestBody.lightTheme
          locale: requestBody.locale
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{certificateOrderName}/verifyDomainOwnership'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify domain ownership for a certificate order
      effect: write
      questions:
      - How do I verify domain ownership for a certificate order?
      - Can I re-run the domain ownership check on a certificate order that is still pending?
      instructions:
      - text: Verify domain ownership for certificate order {order} in {resource_group}, subscription {subscription}.
        slots:
          order: path.certificateOrderName
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Run the domain ownership verification on order {order} now.
        slots:
          order: path.certificateOrderName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/retrieveCertificateActions'].post
  update:
    x-apievangelist-phrasing:
      intent: List actions taken on a certificate order
      effect: read
      questions:
      - What actions have been recorded against my certificate order?
      - Can I see the certificate action history for one order?
      instructions:
      - text: Retrieve the certificate actions for order {order} in {resource_group}, subscription {subscription}.
        slots:
          order: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: List the actions logged on certificate order {order}.
        slots:
          order: path.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CertificateRegistration/certificateOrders/{name}/retrieveEmailHistory'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the email history of a certificate order
      effect: read
      questions:
      - Which emails have been sent out for my certificate order?
      - Is there a record of when certificate emails went out for an order?
      instructions:
      - text: Retrieve the email history for certificate order {order} in {resource_group}, subscription {subscription}.
        slots:
          order: path.name
          resource_group: path.resourceGroupName
          subscription: path.subscriptionId
      - text: Show every email sent about order {order}.
        slots:
          order: path.name
      method: generated
      generated: '2026-09-26'