# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for App Store Connect Build Uploads API
  version: 1.0.0
extends: openapi/ios-builduploads-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/v1/buildUploads'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a build upload
      effect: write
      questions:
      - How do I start uploading a new build to App Store Connect through the API?
      - Can I create a build upload without using Xcode or Transporter?
      instructions:
      - text: Create a build upload with {upload}.
        slots:
          upload: requestBody.data
      - text: Start a new binary upload for my app using {upload}.
        slots:
          upload: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/buildUploads/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a build upload's status
      effect: read
      questions:
      - What is the state of a build upload I started?
      - Did my build upload finish processing or fail?
      instructions:
      - text: Get build upload {upload}.
        slots:
          upload: path.id
      - text: Check the status of upload {upload} and include {include}.
        slots:
          upload: path.id
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/buildUploads/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Cancel and delete a build upload
      effect: destructive
      questions:
      - How do I cancel a build upload that's stuck or wrong?
      - Can I delete a build upload record?
      instructions:
      - text: Delete build upload {upload}.
        slots:
          upload: path.id
      - text: Cancel the binary upload {upload}.
        slots:
          upload: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/buildUploads/{id}/relationships/buildUploadFiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List file IDs in a build upload
      effect: read
      questions:
      - Which file IDs belong to a build upload?
      - Can I get only the identifiers of the files in an upload?
      instructions:
      - text: List only the file IDs in build upload {upload}.
        slots:
          upload: path.id
      - text: Return up to {limit} upload file identifiers for {upload}.
        slots:
          limit: query.limit
          upload: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/buildUploads/{id}/buildUploadFiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List files and upload operations in a build upload
      effect: read
      questions:
      - What files are part of a build upload, with their sizes and upload instructions?
      - Can I see the full file records, including delivery state, for a build upload?
      instructions:
      - text: Show the full files in build upload {upload}.
        slots:
          upload: path.id
      - text: Fetch file details and upload instructions for upload {upload}.
        slots:
          upload: path.id
      method: generated
      generated: '2026-10-01'