# 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-revocation-approvals-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/certificates/revocations/approvalrules'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificate revocation approval rules
      effect: read
      questions:
      - Which approval rules govern certificate revocation requests in my company?
      - What revocation workflow approval rules are set up?
      instructions:
      - text: List all certificate revocation approval rules.
      - text: Show every revocation approval rule for my company.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/certificates/revocations/approvalrules'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a certificate revocation approval rule
      effect: write
      questions:
      - How do I require approval before a certificate can be revoked?
      - Can a revocation request be auto-rejected after some days without approval?
      - Can I require at least two approvers for revocations?
      instructions:
      - text: Create revocation approval rule {name} of type {type} with approvers {approvers} and conditions {conditions}.
        slots:
          name: requestBody.name
          type: requestBody.type
          approvers: requestBody.approvers
          conditions: requestBody.conditions
      - text: Add rule {name} needing at least {atLeast} of {approvers} under {conditions}, type {type}.
        slots:
          name: requestBody.name
          atLeast: requestBody.atLeast
          approvers: requestBody.approvers
          conditions: requestBody.conditions
          type: requestBody.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/certificates/revocations/approvalrules/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a certificate revocation approval rule
      effect: read
      questions:
      - Who approves revocations under a particular approval rule?
      - Can I read one revocation approval rule by its UUID?
      instructions:
      - text: Get revocation approval rule {id}.
        slots:
          id: path.id
      - text: Show the approvers and conditions of approval rule {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/certificates/revocations/approvalrules/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a certificate revocation approval rule
      effect: write
      questions:
      - How do I change the approvers on an existing revocation approval rule?
      - Can I change the priority order of a revocation approval rule?
      instructions:
      - text: Update approval rule {id} with approvers {approvers}, conditions {conditions}, name {name} and type {type}.
        slots:
          id: path.id
          approvers: requestBody.approvers
          conditions: requestBody.conditions
          name: requestBody.name
          type: requestBody.type
      - text: Set priority {priority} on existing approval rule {id}.
        slots:
          id: path.id
          priority: requestBody.priority
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/certificates/revocations/approvalrules/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a certificate revocation approval rule
      effect: destructive
      questions:
      - Can I remove an approval rule from the revocation workflow?
      - Does deleting a revocation approval rule require its UUID rather than a number?
      instructions:
      - text: Delete revocation approval rule {id}.
        slots:
          id: path.id
      - text: Remove approval rule {id} from the revocation workflow.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'