# 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 App Clips API
  version: 1.0.0
extends: openapi/ios-appclips-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/appClips/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an App Clip
      effect: read
      questions:
      - How do I look up an App Clip by ID?
      - What does an App Clip record contain?
      instructions:
      - text: Get App Clip {id}.
        slots:
          id: path.id
      - text: Show me the details of App Clip {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appClips/{id}/relationships/appClipAdvancedExperiences'].get
  update:
    x-apievangelist-phrasing:
      intent: List advanced experience IDs of an App Clip
      effect: read
      questions:
      - Which advanced experience IDs are attached to my App Clip?
      - Can I list only the advanced experience references of an App Clip?
      instructions:
      - text: List only the advanced experience IDs for App Clip {id}.
        slots:
          id: path.id
      - text: Return up to {limit} advanced experience linkages of App Clip {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appClips/{id}/appClipAdvancedExperiences'].get
  update:
    x-apievangelist-phrasing:
      intent: List an App Clip's advanced experiences
      effect: read
      questions:
      - Where can I see the advanced experiences configured for an App Clip?
      - Can I filter an App Clip's advanced experiences by status or place status?
      instructions:
      - text: Show the advanced experiences of App Clip {id}.
        slots:
          id: path.id
      - text: List advanced experiences of App Clip {id} with status {status}.
        slots:
          id: path.id
          status: query.filter[status]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appClips/{id}/relationships/appClipDefaultExperiences'].get
  update:
    x-apievangelist-phrasing:
      intent: List default experience IDs of an App Clip
      effect: read
      questions:
      - Which default experience IDs belong to my App Clip?
      - Can I list only the default experience references of an App Clip?
      instructions:
      - text: List only the default experience IDs for App Clip {id}.
        slots:
          id: path.id
      - text: Return up to {limit} default experience linkages of App Clip {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appClips/{id}/appClipDefaultExperiences'].get
  update:
    x-apievangelist-phrasing:
      intent: List an App Clip's default experiences
      effect: read
      questions:
      - What default experiences are set up for my App Clip?
      - Is there a way to see an App Clip's default experiences with their details?
      instructions:
      - text: Show the default experiences of App Clip {id}.
        slots:
          id: path.id
      - text: List up to {limit} default experiences with details for App Clip {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'