# 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-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: 8
- target: $.paths['/v1/certificaterequests/{id}/approval/{decision}'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve or reject a certificate request
      effect: write
      questions:
      - How do I approve a certificate request waiting on me?
      - Can I reject a pending certificate request and give a reason?
      instructions:
      - text: Mark certificate request {id} as {decision}.
        slots:
          id: path.id
          decision: path.decision
      - text: Record decision {decision} on certificate request {id} with reason {reason}.
        slots:
          decision: path.decision
          id: path.id
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/certificaterequests/approval/bulk/{decision}'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve or reject many certificate requests
      effect: write
      questions:
      - Can I approve a batch of pending certificate requests at once?
      - How do I bulk reject certificate requests?
      instructions:
      - text: Apply decision {decision} to certificate requests {ids}.
        slots:
          decision: path.decision
          ids: requestBody.ids
      - text: Bulk {decision} certificate requests {ids} with reason {reason}.
        slots:
          decision: path.decision
          ids: requestBody.ids
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/certificaterequests/approvalrules'].get
  update:
    x-apievangelist-phrasing:
      intent: List certificate approval rules
      effect: read
      questions:
      - What approval rules govern certificate requests in our company?
      - Which workflow rules decide who approves a certificate?
      instructions:
      - text: List all certificate request approval rules.
      - text: Show our certificate workflow approval rules.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/certificaterequests/approvalrules'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a certificate approval rule
      effect: write
      questions:
      - How do I require approval before certain certificates are issued?
      - Can an approval rule auto-approve renewals?
      instructions:
      - text: Create 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} of type {type}, approvers {approvers}, conditions {conditions}, auto-approve renewals {autoApproveOnRenew}.
        slots:
          name: requestBody.name
          type: requestBody.type
          approvers: requestBody.approvers
          conditions: requestBody.conditions
          autoApproveOnRenew: requestBody.autoApproveOnRenew
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/certificaterequests/approvalrules/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a certificate approval rule
      effect: read
      questions:
      - Who are the approvers on one specific certificate approval rule?
      - What conditions trigger a particular approval rule?
      instructions:
      - text: Get certificate 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/certificaterequests/approvalrules/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a certificate approval rule
      effect: write
      questions:
      - How do I change the approvers on an existing certificate rule?
      - Can I reorder an approval rule's priority?
      instructions:
      - text: Set priority {priority} on approval rule {id}.
        slots:
          priority: requestBody.priority
          id: path.id
      - text: 'Update approval rule {id}: approvers {approvers}.'
        slots:
          id: path.id
          approvers: requestBody.approvers
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/certificaterequests/approvalrules/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a certificate approval rule
      effect: destructive
      questions:
      - How do I remove a certificate approval rule we no longer need?
      - Does deleting an approval rule stop it applying to new requests?
      instructions:
      - text: Delete certificate approval rule {id}.
        slots:
          id: path.id
      - text: Remove the approval rule with UUID {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/certificaterequests/approvalrequests/{entityId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the approval request for a certificate
      effect: read
      questions:
      - Where is a certificate request in its approval workflow?
      - Who still needs to sign off on a particular certificate request?
      instructions:
      - text: Get the approval request for certificate request {entityId}.
        slots:
          entityId: path.entityId
      - text: Show approval status for entity {entityId}.
        slots:
          entityId: path.entityId
      method: generated
      generated: '2026-09-26'