# 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 Sub…
  version: 1.0.0
extends: openapi/palo-alto-networks-issuer-sub-ca-providers-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/subcaproviders'].get
  update:
    x-apievangelist-phrasing:
      intent: List subordinate CA providers
      effect: read
      questions:
      - Which subordinate CA providers are set up for distributed issuance?
      - What sub CA providers do I have and how are they configured?
      instructions:
      - text: List all subordinate CA providers.
      - text: Show every sub CA provider for my distributed issuers.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/distributedissuers/subcaproviders'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a subordinate CA provider
      effect: write
      questions:
      - How do I set up a new subordinate CA provider for distributed issuers?
      - What key algorithm and validity period does a sub CA provider need?
      instructions:
      - text: Create sub CA provider {name} for {commonName} with key algorithm {keyAlgorithm} valid for {validityPeriod}.
        slots:
          name: requestBody.name
          commonName: requestBody.commonName
          keyAlgorithm: requestBody.keyAlgorithm
          validityPeriod: requestBody.validityPeriod
      - text: Set up a {caType} sub CA provider on CA account {caAccountId} with product option {caProductOptionId}.
        slots:
          caType: requestBody.caType
          caAccountId: requestBody.caAccountId
          caProductOptionId: requestBody.caProductOptionId
      - text: Add a subordinate CA provider for organization {organization} and share it with all sub-tenants.
        slots:
          organization: requestBody.organization
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/distributedissuers/subcaproviders/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a subordinate CA provider
      effect: read
      questions:
      - What are the settings of one specific sub CA provider?
      - Can I look up a subordinate CA provider by ID?
      instructions:
      - text: Show sub CA provider {id}.
        slots:
          id: path.id
      - text: Get details of subordinate CA provider {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/distributedissuers/subcaproviders/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a subordinate CA provider
      effect: destructive
      questions:
      - How do I remove a subordinate CA provider?
      - Is deleting a sub CA provider permanent?
      instructions:
      - text: Delete sub CA provider {id}.
        slots:
          id: path.id
      - text: Remove the retired subordinate CA provider {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/distributedissuers/subcaproviders/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a subordinate CA provider
      effect: write
      questions:
      - Can I change just the validity period on an existing sub CA provider?
      - Which sub-tenants can I share an existing subordinate CA provider with?
      instructions:
      - text: Set validity period {validityPeriod} on sub CA provider {id}.
        slots:
          validityPeriod: requestBody.validityPeriod
          id: path.id
      - text: Share subordinate CA provider {id} with sub-tenants {sharedWithSubTsgIds}.
        slots:
          id: path.id
          sharedWithSubTsgIds: requestBody.sharedWithSubTsgIds
      method: generated
      generated: '2026-09-26'