# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Quarantine API
  version: 1.0.0
extends: openapi/harness-quarantine-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: 2
- target: $.paths['/har/api/v1/registry/{registry_ref}/quarantine'].put
  update:
    x-apievangelist-phrasing:
      intent: Quarantine an artifact in a registry
      effect: write
      questions:
      - How do I block a vulnerable package version from being pulled from my registry?
      - Can I quarantine a single file path of an artifact and record why?
      instructions:
      - text: Quarantine artifact {artifact} version {version} in registry {registry} because {reason}.
        slots:
          artifact: requestBody.artifact
          version: requestBody.version
          registry: path.registry_ref
          reason: requestBody.reason
      - text: Quarantine file {file_path} of {artifact} in {registry} with reason {reason}.
        slots:
          file_path: requestBody.filePath
          artifact: requestBody.artifact
          registry: path.registry_ref
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v1/registry/{registry_ref}/quarantine'].delete
  update:
    x-apievangelist-phrasing:
      intent: Release an artifact from quarantine
      effect: destructive
      questions:
      - What does it take to lift quarantine on a package so it can be downloaded again?
      - Can I remove the quarantine from one file path only?
      instructions:
      - text: Remove quarantine from artifact {artifact} version {version} in registry {registry}.
        slots:
          artifact: query.artifact
          version: query.version
          registry: path.registry_ref
      - text: Unquarantine file {file_path} in registry {registry}.
        slots:
          file_path: query.file_path
          registry: path.registry_ref
      method: generated
      generated: '2026-09-26'