# 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 Marketplace Search Details API
  version: 1.0.0
extends: openapi/ios-marketplacesearchdetails-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: 3
- target: $.paths['/v1/marketplaceSearchDetails'].post
  update:
    x-apievangelist-phrasing:
      intent: Set an app's alternative marketplace catalog URL
      effect: write
      questions:
      - How do I register a catalog URL for my app in alternative marketplace search?
      - Can I make my app discoverable in an alternative marketplace's search?
      instructions:
      - text: Create a marketplace search detail {detail}.
        slots:
          detail: requestBody.data
      - text: Add catalog URL {detail} for alternative marketplace search.
        slots:
          detail: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/marketplaceSearchDetails/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an app's marketplace search detail
      effect: destructive
      questions:
      - Can I remove my app's catalog URL from alternative marketplace search?
      - What do I delete to stop my app showing in marketplace search?
      instructions:
      - text: Delete marketplace search detail {detail}.
        slots:
          detail: path.id
      - text: Remove marketplace search configuration {detail}.
        slots:
          detail: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/marketplaceSearchDetails/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change an app's marketplace catalog URL
      effect: write
      questions:
      - Can I change the catalog URL used for alternative marketplace search?
      - How do I edit an existing marketplace search detail?
      instructions:
      - text: Update marketplace search detail {detail} with {changes}.
        slots:
          detail: path.id
          changes: requestBody.data
      - text: Change the catalog URL on marketplace search detail {detail} to {changes}.
        slots:
          detail: path.id
          changes: requestBody.data
      method: generated
      generated: '2026-10-01'