API Evangelist conversational phrasing for Azure API Management REST Certificate API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Azure API Management REST Certificate API
  version: 1.0.0
extends: openapi/microsoft-azure-api-management-certificate-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: 6
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificates on the service
      effect: read
      questions:
      - Which certificates are uploaded to my API Management service?
      - Can I see all the backend authentication certificates on my instance?
      instructions:
      - text: List every certificate on my {serviceName} API Management service.
        slots:
          serviceName: path.serviceName
      - text: Show me the certificates available for backend authentication.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a certificate's details
      effect: read
      questions:
      - How do I check a certificate's subject, thumbprint and expiry?
      - When does a particular certificate on my service expire?
      instructions:
      - text: Get the thumbprint and expiry of certificate {certificateId} in service {serviceName}.
        slots:
          certificateId: path.certificateId
          serviceName: path.serviceName
      - text: Show me this certificate's thumbprint and expiration date.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Upload or replace a backend certificate
      effect: write
      questions:
      - How do I upload a certificate API Management uses to authenticate to my backend?
      - Can I replace an existing backend certificate with a new one?
      instructions:
      - text: Upload a backend authentication certificate as {certificateId} to service {serviceName}.
        slots:
          certificateId: path.certificateId
          serviceName: path.serviceName
      - text: Replace this certificate with a newer one.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a certificate
      effect: destructive
      questions:
      - How can I remove a certificate from my service?
      - Is deleting a backend certificate permanent?
      instructions:
      - text: Delete certificate {certificateId} from {serviceName}.
        slots:
          certificateId: path.certificateId
          serviceName: path.serviceName
      - text: Remove this certificate from API Management.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}'].head
  update:
    x-apievangelist-phrasing:
      intent: Get a certificate's ETag
      effect: read
      questions:
      - Can I read a certificate's ETag without downloading its details?
      - Does a certificate with a given ID exist on my service?
      instructions:
      - text: Check the ETag of certificate {certificateId} on {serviceName}.
        slots:
          certificateId: path.certificateId
          serviceName: path.serviceName
      - text: Confirm this certificate exists from its entity state header.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/certificates/{certificateId}/refreshSecret'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh a certificate from Key Vault
      effect: write
      questions:
      - How do I pull the latest version of a Key Vault certificate into API Management?
      - Can I make the service pick up a rotated certificate from Key Vault right away?
      instructions:
      - text: Refresh certificate {certificateId} from Key Vault on service {serviceName}.
        slots:
          certificateId: path.certificateId
          serviceName: path.serviceName
      - text: Re-sync this Key Vault-backed certificate so the backend uses the new secret.
      method: generated
      generated: '2026-10-01'