# 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 Nominations API
  version: 1.0.0
extends: openapi/ios-nominations-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/nominations'].get
  update:
    x-apievangelist-phrasing:
      intent: List my featuring nominations
      effect: read
      questions:
      - Which App Store featuring nominations have I drafted or submitted?
      - Can I filter nominations by type or by the apps they cover?
      instructions:
      - text: List my nominations in state {state}.
        slots:
          state: query.filter[state]
      - text: Show {state} nominations of type {type} for app {app}.
        slots:
          state: query.filter[state]
          type: query.filter[type]
          app: query.filter[relatedApps]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/nominations'].post
  update:
    x-apievangelist-phrasing:
      intent: Nominate an app for App Store featuring
      effect: write
      questions:
      - How do I nominate my app or launch for featuring on the App Store?
      - Can I nominate an upcoming app update for editorial consideration?
      instructions:
      - text: Create a featuring nomination {nomination}.
        slots:
          nomination: requestBody.data
      - text: Submit a new App Store featuring nomination with {nomination}.
        slots:
          nomination: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/nominations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a featuring nomination
      effect: read
      questions:
      - What did I write in a specific featuring nomination?
      - Has my nomination been submitted or is it still a draft?
      instructions:
      - text: Get nomination {nomination}.
        slots:
          nomination: path.id
      - text: Show the details and state of nomination {nomination}.
        slots:
          nomination: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/nominations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a featuring nomination
      effect: destructive
      questions:
      - Can I delete a nomination I no longer want to send?
      - Is it possible to remove a draft featuring nomination?
      instructions:
      - text: Delete nomination {nomination}.
        slots:
          nomination: path.id
      - text: Remove featuring nomination {nomination} permanently.
        slots:
          nomination: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/nominations/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a featuring nomination
      effect: write
      questions:
      - Can I edit the description or publish date of an existing nomination?
      - Which nomination fields can I change before submitting it?
      instructions:
      - text: Update nomination {nomination} with {changes}.
        slots:
          nomination: path.id
          changes: requestBody.data
      - text: Edit featuring nomination {nomination} to {changes}.
        slots:
          nomination: path.id
          changes: requestBody.data
      method: generated
      generated: '2026-10-01'