# 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 Event Localizations API
  version: 1.0.0
extends: openapi/ios-appeventlocalizations-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: 8
- target: $.paths['/v1/appEventLocalizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a language to an in-app event
      effect: write
      questions:
      - How do I add a localized name and description for an in-app event?
      - Can I localize my App Store in-app event into another language?
      instructions:
      - text: Create an in-app event localization with {data}.
        slots:
          data: requestBody.data
      - text: Add a new language version for an app event using {data}.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEventLocalizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an in-app event localization
      effect: read
      questions:
      - Can I view the localized text for one in-app event language?
      - What does a single app event localization contain?
      instructions:
      - text: Show app event localization {id}.
        slots:
          id: path.id
      - text: Fetch in-app event localization {id} including {include}.
        slots:
          id: path.id
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEventLocalizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an in-app event localization
      effect: destructive
      questions:
      - How do I remove a language from an in-app event?
      - Can I delete an app event localization I added by mistake?
      instructions:
      - text: Delete app event localization {id}.
        slots:
          id: path.id
      - text: Remove the in-app event language version {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEventLocalizations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an in-app event localization
      effect: write
      questions:
      - Can I edit the localized name or descriptions of an in-app event?
      - How do I fix a typo in an app event's translated text?
      instructions:
      - text: Update app event localization {id} with {data}.
        slots:
          id: path.id
          data: requestBody.data
      - text: Change the localized text of event localization {id} to {data}.
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEventLocalizations/{id}/relationships/appEventScreenshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List IDs of an event localization's screenshots
      effect: read
      questions:
      - Can I get just the screenshot IDs for an in-app event localization?
      - Which screenshot identifiers are attached to an event language version?
      instructions:
      - text: Give me the screenshot IDs for app event localization {id}.
        slots:
          id: path.id
      - text: Return {limit} screenshot linkages for event localization {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEventLocalizations/{id}/appEventScreenshots'].get
  update:
    x-apievangelist-phrasing:
      intent: List an event localization's screenshots
      effect: read
      questions:
      - What screenshots are uploaded for an in-app event in a given language?
      - Where can I see the full screenshot records for an app event localization?
      instructions:
      - text: Show the screenshots for app event localization {id}.
        slots:
          id: path.id
      - text: List event screenshots of localization {id} including {include}.
        slots:
          id: path.id
          include: query.include
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEventLocalizations/{id}/relationships/appEventVideoClips'].get
  update:
    x-apievangelist-phrasing:
      intent: List IDs of an event localization's video clips
      effect: read
      questions:
      - Can I fetch only the video clip IDs for an in-app event localization?
      - Which video clip identifiers are linked to an event language version?
      instructions:
      - text: Give me the video clip IDs for app event localization {id}.
        slots:
          id: path.id
      - text: Return {limit} video clip linkages for event localization {id}.
        slots:
          id: path.id
          limit: query.limit
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appEventLocalizations/{id}/appEventVideoClips'].get
  update:
    x-apievangelist-phrasing:
      intent: List an event localization's video clips
      effect: read
      questions:
      - What video clips are attached to my in-app event in this language?
      - Can I see full details of the videos on an app event localization?
      instructions:
      - text: Show the video clips for app event localization {id}.
        slots:
          id: path.id
      - text: List event video clips of localization {id} including {include}.
        slots:
          id: path.id
          include: query.include
      method: generated
      generated: '2026-10-01'