# 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 TLS Server…
  version: 1.0.0
extends: openapi/palo-alto-networks-tls-server-endpoints-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: 4
- target: $.paths['/outagedetection/v1/certificateinstances'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificate installations on TLS endpoints
      effect: read
      questions:
      - Where is each certificate installed across my TLS server endpoints?
      - Can I list certificate installations for a given hostname or IP address?
      instructions:
      - text: List certificate installations on hostname {hostname}.
        slots:
          hostname: query.hostname
      - text: Show certificate instances found at IP {ipAddress} from source {source}.
        slots:
          ipAddress: query.ipAddress
          source: query.source
      method: generated
      generated: '2026-09-26'
- target: $.paths['/outagedetection/v1/certificateinstances/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a certificate installation's details
      effect: read
      questions:
      - How do I see the details of one certificate installation on a TLS endpoint?
      - What information is kept about a single certificate instance?
      instructions:
      - text: Get certificate installation {id}.
        slots:
          id: path.id
      - text: Show the endpoint details for certificate instance {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/outagedetection/v1/certificateinstances/validation'].post
  update:
    x-apievangelist-phrasing:
      intent: Request TLS validation of certificate installations
      effect: write
      questions:
      - How do I recheck that certificates are correctly installed on specific TLS endpoints?
      - Can I submit several certificate installations for validation at once?
      instructions:
      - text: Validate certificate installations {instanceIds}.
        slots:
          instanceIds: requestBody.instanceIds
      - text: Submit instances {instanceIds} for a TLS endpoint validation check.
        slots:
          instanceIds: requestBody.instanceIds
      method: generated
      generated: '2026-09-26'
- target: $.paths['/outagedetection/v1/certificateinstancesearch'].post
  update:
    x-apievangelist-phrasing:
      intent: Search certificate installations by criteria
      effect: read
      questions:
      - Which TLS endpoints are serving certificates that expire soon?
      - Can I search certificate installations by signature hash algorithm and sort them?
      instructions:
      - text: Search certificate installations matching {expression}.
        slots:
          expression: requestBody.expression
      - text: Search certificate instances by {expression}, ordered by {ordering}, paged with {paging}.
        slots:
          expression: requestBody.expression
          ordering: requestBody.ordering
          paging: requestBody.paging
      method: generated
      generated: '2026-09-26'