# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Harness Upload API
  version: 1.0.0
extends: openapi/harness-upload-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['/code/api/v1/repos/{repo_identifier}/uploads'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a file to a code repository
      effect: write
      questions:
      - How do I upload an attachment or artifact to a Harness Code repo?
      - Can I attach a file to a repository for use in comments or pull requests?
      instructions:
      - text: Upload a file to repo {repo} in account {account}.
        slots:
          repo: path.repo_identifier
          account: query.accountIdentifier
      - text: Attach this artifact to repository {repo} in project {project}.
        slots:
          repo: path.repo_identifier
          project: query.projectIdentifier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/code/api/v1/repos/{repo_identifier}/uploads/{file_ref}'].get
  update:
    x-apievangelist-phrasing:
      intent: Download an uploaded file from a repo
      effect: read
      questions:
      - Can I download a file that was previously uploaded to a repo?
      - Where do I fetch a repository upload by its file reference?
      instructions:
      - text: Download upload {file} from repo {repo} in account {account}.
        slots:
          file: path.file_ref
          repo: path.repo_identifier
          account: query.accountIdentifier
      - text: Fetch the uploaded file {file} attached to repository {repo}.
        slots:
          file: path.file_ref
          repo: path.repo_identifier
      method: generated
      generated: '2026-09-26'