# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Cloud API Overview Remediations API
  version: 1.0.0
extends: openapi/palo-alto-networks-remediations-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: 3
- target: $.paths['/code/api/v1/remediations/buildtime'].post
  update:
    x-apievangelist-phrasing:
      intent: Open or update a PR with build-time fixes
      effect: write
      questions:
      - How do I have code security open a pull request that fixes misconfigured resources?
      - Can I push remediation commits to an existing PR instead of opening a new one?
      instructions:
      - text: Create a fix PR in {owner}/{repoName} from branch {sourceBranchName} for resources {resources}.
        slots:
          owner: requestBody.owner
          repoName: requestBody.repoName
          sourceBranchName: requestBody.sourceBranchName
          resources: requestBody.resources
      - text: Push fixes for {resources} to PR {pr} in {owner}/{repoName} on {sourceBranchName}.
        slots:
          resources: requestBody.resources
          pr: requestBody.pr
          owner: requestBody.owner
          repoName: requestBody.repoName
          sourceBranchName: requestBody.sourceBranchName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/remediations/buildtime/{fixId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the fix code for a remediation
      effect: read
      questions:
      - How do I see the suggested code change for a specific fix?
      - Can I preview remediation fix code before opening a PR?
      instructions:
      - text: Get the fix code for fix {fixId}.
        slots:
          fixId: path.fixId
      - text: Show the remediation code change for {fixId}.
        slots:
          fixId: path.fixId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/remediations/buildtime/baseFile/{filename}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the original file for a remediation
      effect: read
      questions:
      - Can I view the original file a remediation will modify?
      - How do I get the base file content before a fix is applied?
      instructions:
      - text: Get the base file {filename} for remediation.
        slots:
          filename: path.filename
      - text: Show the unmodified content of {filename}.
        slots:
          filename: path.filename
      method: generated
      generated: '2026-09-26'