API Evangelist conversational phrasing for Shopify Country API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Shopify Country API
  version: 1.0.0
extends: openapi/shopify-country-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 12
- target: $.paths['/admin/api/2020-01/countries/{country_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a shipping country (2020-01 API)
      effect: destructive
      questions:
      - How do I remove a country from my store's shipping countries on the 2020-01 API?
      - Can I delete a country I no longer sell to with the 2020-01 version?
      instructions:
      - text: Delete country {country} using the 2020-01 API.
        slots:
          country: path.country_id
      - text: Remove country {country} from the store's country list, version 2020-01.
        slots:
          country: path.country_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/countries/{country_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a shipping country (2020-04 API)
      effect: destructive
      questions:
      - Which 2020-04 endpoint deletes a country from the shop?
      - Is deleting a store country supported in the 2020-04 release?
      instructions:
      - text: Remove country {country} on 2020-04.
        slots:
          country: path.country_id
      - text: Drop country {country} from my shop settings via the 2020-04 release.
        slots:
          country: path.country_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/countries/{country_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a shipping country (2020-07 API)
      effect: destructive
      questions:
      - Where do I delete a country record in version 2020-07?
      - What happens to its provinces when I remove a store country in 2020-07?
      instructions:
      - text: Delete country {country} through the 2020-07 version.
        slots:
          country: path.country_id
      - text: Erase the country entry {country} with 2020-07.
        slots:
          country: path.country_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/countries/{country_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a shipping country (2020-10 API)
      effect: destructive
      questions:
      - How can I stop offering a country by deleting it with the 2020-10 API?
      - Does the 2020-10 Admin API let me delete a country from my store?
      instructions:
      - text: Remove country {country} with the 2020-10 Admin API.
        slots:
          country: path.country_id
      - text: Delete the store country {country}, API version 2020-10.
        slots:
          country: path.country_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/countries/{country_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a shipping country (2021-01 API)
      effect: destructive
      questions:
      - Can I delete a country using the 2021-01 release?
      - Which 2021-01 call permanently removes a country from the shop?
      instructions:
      - text: Using 2021-01, delete country {country}.
        slots:
          country: path.country_id
      - text: Take country {country} out of the store on the 2021-01 release.
        slots:
          country: path.country_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/countries/{country_id}.json'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a shipping country (unstable API)
      effect: destructive
      questions:
      - Is removing a store country possible on the unstable API version?
      - How would I delete a country against the unstable release?
      instructions:
      - text: Delete country {country} on the unstable API.
        slots:
          country: path.country_id
      - text: On the unstable version, remove country {country} from the shop.
        slots:
          country: path.country_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/countries/{country_id}/provinces/{province_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one province of a country (2020-01 API)
      effect: read
      questions:
      - How do I fetch a single province or state for a country on the 2020-01 API?
      - Can I return only certain fields for a province lookup in 2020-01?
      instructions:
      - text: Show province {province} of country {country} using the 2020-01 API.
        slots:
          country: path.country_id
          province: path.province_id
      - text: Get only {fields} for province {province} in country {country}, version 2020-01.
        slots:
          country: path.country_id
          province: path.province_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/countries/{country_id}/provinces/{province_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one province of a country (2020-04 API)
      effect: read
      questions:
      - Which 2020-04 call returns one province by ID within a country?
      - What does a single province record contain in the 2020-04 release?
      instructions:
      - text: Retrieve province {province} for country {country} on 2020-04.
        slots:
          country: path.country_id
          province: path.province_id
      - text: Fetch {fields} of province {province} under country {country} via the 2020-04 release.
        slots:
          country: path.country_id
          province: path.province_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/countries/{country_id}/provinces/{province_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one province of a country (2020-07 API)
      effect: read
      questions:
      - Where do I read one state or province of a store country in version 2020-07?
      - Does 2020-07 support getting a province by its ID?
      instructions:
      - text: Get province {province} in country {country} through the 2020-07 version.
        slots:
          country: path.country_id
          province: path.province_id
      - text: Look up just {fields} on province {province} of country {country} with 2020-07.
        slots:
          country: path.country_id
          province: path.province_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/countries/{country_id}/provinces/{province_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one province of a country (2020-10 API)
      effect: read
      questions:
      - How can I check the settings for one province in a country using the 2020-10 API?
      - Does the 2020-10 Admin API let me trim a province response to chosen fields?
      instructions:
      - text: Show me province {province} of country {country} on the 2020-10 API.
        slots:
          country: path.country_id
          province: path.province_id
      - text: Return {fields} for country {country}'s province {province}, API 2020-10.
        slots:
          country: path.country_id
          province: path.province_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/countries/{country_id}/provinces/{province_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one province of a country (2021-01 API)
      effect: read
      questions:
      - Can I retrieve a single province of a country in the 2021-01 release?
      - Which endpoint in 2021-01 gives me one province by ID?
      instructions:
      - text: Using 2021-01, fetch province {province} of country {country}.
        slots:
          country: path.country_id
          province: path.province_id
      - text: Display {fields} of province {province} in country {country} on the 2021-01 release.
        slots:
          country: path.country_id
          province: path.province_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/countries/{country_id}/provinces/{province_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one province of a country (unstable API)
      effect: read
      questions:
      - Is reading a single province available on the unstable API?
      - How would I get one province of a country from the unstable version?
      instructions:
      - text: Retrieve province {province} of country {country} from the unstable API.
        slots:
          country: path.country_id
          province: path.province_id
      - text: On the unstable version, look up {fields} for province {province} in country {country}.
        slots:
          country: path.country_id
          province: path.province_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'