# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for TLS Protect Cloud API for Strata Cloud Manager Certificate…
  version: 1.0.0
extends: openapi/palo-alto-networks-certificate-inventory-monitoring-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['/outagedetection/v1/inventorymonitoringconfig/{type}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a certificate inventory monitoring config
      effect: read
      questions:
      - How is certificate inventory monitoring currently configured for a given type?
      - Can I read the inventory monitoring settings for one configuration type?
      instructions:
      - text: Get the inventory monitoring configuration of type {type}.
        slots:
          type: path.type
      - text: Show current certificate inventory monitoring settings for {type}.
        slots:
          type: path.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/outagedetection/v1/inventorymonitoringconfig/{type}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a certificate inventory monitoring config
      effect: write
      questions:
      - How do I change the certificate inventory monitoring configuration for a type?
      - Can I replace the monitoring settings used for certificate outage detection?
      instructions:
      - text: Update inventory monitoring configuration {type} to {inventoryMonitoringConfiguration}.
        slots:
          type: path.type
          inventoryMonitoringConfiguration: requestBody.inventoryMonitoringConfiguration
      - text: Replace the {type} certificate monitoring settings with {inventoryMonitoringConfiguration}.
        slots:
          type: path.type
          inventoryMonitoringConfiguration: requestBody.inventoryMonitoringConfiguration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/outagedetection/v1/inventorymonitoringconfig/{type}/scheduler'].put
  update:
    x-apievangelist-phrasing:
      intent: Update or trigger the inventory monitoring scheduler
      effect: write
      questions:
      - Can I kick off a certificate inventory monitoring run right now?
      - How do I update the scheduler for one inventory monitoring type?
      instructions:
      - text: Update the inventory monitoring scheduler for {type}.
        slots:
          type: path.type
      - text: Run the {type} inventory monitoring scheduler now (runNow {runNow}).
        slots:
          type: path.type
          runNow: query.runNow
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/expirationnotifications/tenantconfiguration'].get
  update:
    x-apievangelist-phrasing:
      intent: Get certificate expiration notification settings
      effect: read
      questions:
      - Who gets notified when our certificates are about to expire?
      - Which channels deliver certificate expiration alerts for my tenant?
      instructions:
      - text: Show my tenant's certificate expiration notification configuration.
      - text: Check whether certificate expiry notifications are enabled.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/expirationnotifications/tenantconfiguration'].put
  update:
    x-apievangelist-phrasing:
      intent: Update certificate expiration notification settings
      effect: write
      questions:
      - How do I add extra recipients to certificate expiration notifications?
      - Can I fall back to PKI admins when a certificate has no owner to notify?
      - Is it possible to leave sensitive certificate details out of expiry alerts?
      instructions:
      - text: Turn certificate expiration notifications on (enabled {enabled}) via channels {channels}.
        slots:
          enabled: requestBody.enabled
          channels: requestBody.channels
      - text: Add {additionalRecipients} as extra recipients of certificate expiry notifications.
        slots:
          additionalRecipients: requestBody.additionalRecipients
      - text: Notify personas {personas} about expiring certificates, with fallbackToPKIAdmin {fallbackToPKIAdmin}.
        slots:
          personas: requestBody.personas
          fallbackToPKIAdmin: requestBody.fallbackToPKIAdmin
      method: generated
      generated: '2026-09-26'