# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Registry V3 - Transfer API
  version: 1.0.0
extends: openapi/harness-registry-v3-transfer-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['/har/api/v3/bulk-download'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a bulk download of registry packages
      effect: write
      questions:
      - Can I download many artifact registry packages as one archive?
      - How do I request a bulk download of specific package versions?
      instructions:
      - text: Start a bulk download of packages {packageIds} in account {account_identifier}.
        slots:
          packageIds: requestBody.packageIds
          account_identifier: query.account_identifier
      - text: Bundle versions {versionIds} into a download named {outputFileName} for account {account_identifier}.
        slots:
          versionIds: requestBody.versionIds
          outputFileName: requestBody.outputFileName
          account_identifier: query.account_identifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v3/bulk-download/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a bulk download request's status
      effect: read
      questions:
      - Is my bulk package download ready yet?
      - What state is a registry bulk download request in?
      instructions:
      - text: Check the status of bulk download {id} in account {account_identifier}.
        slots:
          id: path.id
          account_identifier: query.account_identifier
      - text: Tell me whether bulk download request {id} has finished.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/har/api/v3/copy'].post
  update:
    x-apievangelist-phrasing:
      intent: Copy artifacts between registries
      effect: write
      questions:
      - Can I copy packages from one artifact registry to another?
      - How do I promote artifacts by copying them to a target registry?
      instructions:
      - text: Copy {source} to {target} in account {account_identifier}.
        slots:
          source: requestBody.source
          target: requestBody.target
          account_identifier: query.account_identifier
      - text: Copy the registry resources at {source} into {target}.
        slots:
          source: requestBody.source
          target: requestBody.target
      method: generated
      generated: '2026-09-26'