# 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 Background Asset Versions API
  version: 1.0.0
extends: openapi/ios-backgroundassetversions-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: 4
- target: $.paths['/v1/backgroundAssetVersions'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a background asset version
      effect: write
      questions:
      - How do I create a new version of a background asset for my app?
      - What do I send to start a background asset version?
      instructions:
      - text: Create a background asset version with {data}.
        slots:
          data: requestBody.data
      - text: Start a new background asset version using {data}.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/backgroundAssetVersions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a background asset version
      effect: read
      questions:
      - What state is my background asset version in?
      - Can I look up one background asset version by ID?
      instructions:
      - text: Show background asset version {id}.
        slots:
          id: path.id
      - text: Fetch background asset version {id} including {include}.
        slots:
          id: path.id
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/backgroundAssetVersions/{id}/relationships/backgroundAssetUploadFiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List IDs of a version's upload files
      effect: read
      questions:
      - Can I get just the upload file IDs for a background asset version?
      - Which upload file identifiers belong to an asset version?
      instructions:
      - text: Give me the upload file IDs for background asset version {id}.
        slots:
          id: path.id
      - text: Return {limit} upload file linkages for asset version {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/backgroundAssetVersions/{id}/backgroundAssetUploadFiles'].get
  update:
    x-apievangelist-phrasing:
      intent: List upload files of a background asset version
      effect: read
      questions:
      - What files were uploaded for a background asset version and are they processed?
      - Where do I see full upload file records for an asset version?
      instructions:
      - text: Show the upload files for background asset version {id}.
        slots:
          id: path.id
      - text: List up to {limit} uploaded files with their status for asset version {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'