# 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 Issuer…
  version: 1.0.0
extends: openapi/palo-alto-networks-issuer-configurations-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['/v1/distributedissuers/configurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Issuer configurations
      effect: read
      questions:
      - Which distributed Issuer configurations have been set up?
      - What Sub CA providers and policies are linked across my Issuer configurations?
      instructions:
      - text: List all Issuer configurations.
      - text: Show every distributed issuer configuration with its linked Sub CA provider.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/distributedissuers/configurations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an Issuer configuration
      effect: write
      questions:
      - How do I link a Sub CA provider, issuance policies and an identity provider into a new Issuer configuration?
      - Can I require a minimum TLS version on a new Issuer configuration?
      instructions:
      - text: Create Issuer configuration {name} using Sub CA provider {subCaProviderId} and policies {policyIds}.
        slots:
          name: requestBody.name
          subCaProviderId: requestBody.subCaProviderId
          policyIds: requestBody.policyIds
      - text: Add issuer config {name} with provider {subCaProviderId}, policies {policyIds} and minimum TLS {minTlsVersion}.
        slots:
          name: requestBody.name
          subCaProviderId: requestBody.subCaProviderId
          policyIds: requestBody.policyIds
          minTlsVersion: requestBody.minTlsVersion
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/distributedissuers/configurations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Issuer configuration
      effect: read
      questions:
      - Which policies and Sub CA provider does a specific Issuer configuration use?
      - Can I look up one Issuer configuration by its UUID?
      instructions:
      - text: Get Issuer configuration {id}.
        slots:
          id: path.id
      - text: Show the client authentication settings of issuer config {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/distributedissuers/configurations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an Issuer configuration
      effect: destructive
      questions:
      - Will Issuer instances stop working if I delete the configuration they use?
      - Can I remove an unused Issuer configuration?
      instructions:
      - text: Delete Issuer configuration {id}.
        slots:
          id: path.id
      - text: Remove issuer config {id} once no Issuer instances use it.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/distributedissuers/configurations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an Issuer configuration
      effect: write
      questions:
      - Can I swap the policies on an Issuer configuration without touching other fields?
      - Is it possible to raise the minimum TLS version of an existing Issuer configuration?
      instructions:
      - text: Update Issuer configuration {id} to use policies {policyIds}.
        slots:
          id: path.id
          policyIds: requestBody.policyIds
      - text: Set minimum TLS version on issuer config {id} to {minTlsVersion}.
        slots:
          id: path.id
          minTlsVersion: requestBody.minTlsVersion
      method: generated
      generated: '2026-09-26'