# 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 Infos API
  version: 1.0.0
extends: openapi/ios-appinfos-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: 20
- target: $.paths['/v1/appInfos/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's App Store info record
      effect: read
      questions:
      - How do I look up an app info record by ID?
      - What does an app's App Store info record contain?
      instructions:
      - text: Get app info {id}.
        slots:
          id: path.id
      - text: Show me the App Store info record {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an app's App Store info
      effect: write
      questions:
      - Can I change my app's App Store info record, such as its categories?
      - Is it possible to edit an app info record after it's created?
      instructions:
      - text: Update app info {id} with {data}.
        slots:
          id: path.id
          data: requestBody.data
      - text: 'Apply these changes to app info {id}: {data}.'
        slots:
          id: path.id
          data: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/relationships/ageRatingDeclaration'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the age rating declaration ID for an app
      effect: read
      questions:
      - Which age rating declaration ID is linked to my app info?
      - Can I get only the age rating declaration reference for an app info record?
      instructions:
      - text: Give me only the age rating declaration ID for app info {id}.
        slots:
          id: path.id
      - text: Return the age rating declaration linkage of app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/ageRatingDeclaration'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's age rating declaration
      effect: read
      questions:
      - Where can I see the age rating questionnaire answers for my app?
      - What content did I declare for my app's age rating?
      instructions:
      - text: Show the age rating declaration for app info {id}.
        slots:
          id: path.id
      - text: Fetch the full age rating answers attached to app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/relationships/appInfoLocalizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List localization IDs of an app info record
      effect: read
      questions:
      - Which localization IDs belong to an app info record?
      - Can I list only the app info localization references?
      instructions:
      - text: List only the localization IDs of app info {id}.
        slots:
          id: path.id
      - text: Return up to {limit} localization linkages for app info {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/appInfoLocalizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's localized App Store info
      effect: read
      questions:
      - How do I see my app's localized App Store details for each language?
      - Can I fetch the app info localization for just one locale?
      instructions:
      - text: Show all localizations of app info {id}.
        slots:
          id: path.id
      - text: Get the {locale} localization for app info {id}.
        slots:
          locale: query.filter[locale]
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/relationships/primaryCategory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the primary category ID of an app
      effect: read
      questions:
      - Which category ID is set as my app's primary category?
      - Can I get just the primary category reference from an app info record?
      instructions:
      - text: Give me only the primary category ID of app info {id}.
        slots:
          id: path.id
      - text: Return the primary category linkage for app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/primaryCategory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's primary App Store category
      effect: read
      questions:
      - What primary App Store category is my app listed under?
      - Where do I see the full primary category details for my app?
      instructions:
      - text: Show the primary category for app info {id}.
        slots:
          id: path.id
      - text: Fetch the full primary category record of app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/relationships/primarySubcategoryOne'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the first primary subcategory ID
      effect: read
      questions:
      - What's the ID of the first subcategory under my app's primary category?
      - Can I get only the first primary subcategory reference?
      instructions:
      - text: Give me only the first primary subcategory ID of app info {id}.
        slots:
          id: path.id
      - text: Return the primary subcategory one linkage for app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/primarySubcategoryOne'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's first primary subcategory
      effect: read
      questions:
      - Which first subcategory is set under my app's primary category?
      - Can I view the details of primary subcategory one for my app?
      instructions:
      - text: Show the first subcategory under the primary category for app info {id}.
        slots:
          id: path.id
      - text: Fetch primary subcategory one details of app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/relationships/primarySubcategoryTwo'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the second primary subcategory ID
      effect: read
      questions:
      - What's the ID of the second subcategory under my app's primary category?
      - Can I get only the second primary subcategory reference?
      instructions:
      - text: Give me only the second primary subcategory ID of app info {id}.
        slots:
          id: path.id
      - text: Return the primary subcategory two linkage for app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/primarySubcategoryTwo'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's second primary subcategory
      effect: read
      questions:
      - Which second subcategory is set under my app's primary category?
      - Can I view the details of primary subcategory two for my app?
      instructions:
      - text: Show the second subcategory under the primary category for app info {id}.
        slots:
          id: path.id
      - text: Fetch primary subcategory two details of app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/relationships/secondaryCategory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the secondary category ID of an app
      effect: read
      questions:
      - Which category ID is set as my app's secondary category?
      - Is there a lightweight way to fetch only my app's secondary category reference?
      instructions:
      - text: Give me only the secondary category ID of app info {id}.
        slots:
          id: path.id
      - text: Return the secondary category linkage for app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/secondaryCategory'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's secondary App Store category
      effect: read
      questions:
      - What secondary App Store category is my app listed under?
      - Where do I see the full secondary category details for my app?
      instructions:
      - text: Show the secondary category for app info {id}.
        slots:
          id: path.id
      - text: Fetch the full secondary category record of app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/relationships/secondarySubcategoryOne'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the first secondary subcategory ID
      effect: read
      questions:
      - What's the ID of the first subcategory under my app's secondary category?
      - Can I get only the first secondary subcategory reference?
      instructions:
      - text: Give me only the first secondary subcategory ID of app info {id}.
        slots:
          id: path.id
      - text: Return the secondary subcategory one linkage for app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/secondarySubcategoryOne'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's first secondary subcategory
      effect: read
      questions:
      - Which first subcategory is set under my app's secondary category?
      - Can I view the details of secondary subcategory one for my app?
      instructions:
      - text: Show the first subcategory under the secondary category for app info {id}.
        slots:
          id: path.id
      - text: Fetch secondary subcategory one details of app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/relationships/secondarySubcategoryTwo'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the second secondary subcategory ID
      effect: read
      questions:
      - What's the ID of the second subcategory under my app's secondary category?
      - Can I get only the second secondary subcategory reference?
      instructions:
      - text: Give me only the second secondary subcategory ID of app info {id}.
        slots:
          id: path.id
      - text: Return the secondary subcategory two linkage for app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/secondarySubcategoryTwo'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's second secondary subcategory
      effect: read
      questions:
      - Which second subcategory is set under my app's secondary category?
      - Can I view the details of secondary subcategory two for my app?
      instructions:
      - text: Show the second subcategory under the secondary category for app info {id}.
        slots:
          id: path.id
      - text: Fetch secondary subcategory two details of app info {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/relationships/territoryAgeRatings'].get
  update:
    x-apievangelist-phrasing:
      intent: List territory age rating IDs for an app
      effect: read
      questions:
      - Which territory age rating IDs are tied to my app info?
      - Can I list only the territory age rating references for an app?
      instructions:
      - text: List only the territory age rating IDs of app info {id}.
        slots:
          id: path.id
      - text: Return up to {limit} territory age rating linkages for app info {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appInfos/{id}/territoryAgeRatings'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's age ratings by territory
      effect: read
      questions:
      - What age rating does my app have in each country or region?
      - How do I see territory-specific age ratings for my app?
      instructions:
      - text: Show the age ratings by territory for app info {id}.
        slots:
          id: path.id
      - text: List up to {limit} territory age ratings with details for app info {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'