# 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 Categories API
  version: 1.0.0
extends: openapi/ios-app-categories-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: 6
- target: $.paths['/v1/appCategories'].get
  update:
    x-apievangelist-phrasing:
      intent: List App Store categories
      effect: read
      questions:
      - What categories can I put my app in on the App Store?
      - Can I list only top-level categories for a specific platform?
      instructions:
      - text: List all App Store categories.
      - text: List app categories available on {platforms}.
        slots:
          platforms: query.filter[platforms]
      - text: List categories where having a parent is {hasParent}.
        slots:
          hasParent: query.exists[parent]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCategories/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an App Store category
      effect: read
      questions:
      - What platforms does a specific App Store category support?
      - Can I look up a single category like GAMES by its ID?
      instructions:
      - text: Show app category {id}.
        slots:
          id: path.id
      - text: Get the details of category {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCategories/{id}/relationships/parent'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the parent category ID
      effect: read
      questions:
      - Can I get just the parent category ID of a subcategory?
      - Which parent identifier does a category point to?
      instructions:
      - text: Get only the parent category ID of {id}.
        slots:
          id: path.id
      - text: Return the parent linkage for category {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCategories/{id}/parent'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a category's parent category
      effect: read
      questions:
      - What top-level category does a subcategory like Puzzle sit under?
      - Can I get the full parent category record?
      instructions:
      - text: Show the parent category of {id}.
        slots:
          id: path.id
      - text: Which category is {id} nested under.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCategories/{id}/relationships/subcategories'].get
  update:
    x-apievangelist-phrasing:
      intent: List subcategory IDs of a category
      effect: read
      questions:
      - Can I get just the subcategory IDs of a category?
      - Which subcategory identifiers belong to Games?
      instructions:
      - text: List only the subcategory IDs of category {id}.
        slots:
          id: path.id
      - text: Return up to {limit} subcategory linkages for category {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/appCategories/{id}/subcategories'].get
  update:
    x-apievangelist-phrasing:
      intent: List a category's subcategories
      effect: read
      questions:
      - What subcategories exist under a top-level App Store category?
      - Can I see the full subcategory records for Games or Stickers?
      instructions:
      - text: Show the subcategories of category {id}.
        slots:
          id: path.id
      - text: List the full subcategory details under {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'