# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Shopify Fulfillment API
  version: 1.0.0
extends: openapi/shopify-fulfillment-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: 95
- target: $.paths['/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/cancellation_request.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Request cancellation of a fulfillment order (2020-01)
      effect: write
      questions:
      - Using the 2020-01 API, how do I ask a fulfillment service to cancel an order it holds?
      - Can a cancellation request sent through the January 2020 API include a reason?
      instructions:
      - text: Send a cancellation request for fulfillment order {fulfillment_order} using 2020-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: On the January 2020 API, ask the fulfillment service to cancel {fulfillment_order} because {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/cancellation_request/accept.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a cancellation request (2020-01)
      effect: destructive
      questions:
      - As a fulfillment service on 2020-01, how do I agree to a merchant's cancellation request?
      - Can I leave a note when accepting a cancellation in the January 2020 API?
      instructions:
      - text: Accept the pending cancellation request on fulfillment order {fulfillment_order} using 2020-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: On January 2020, approve the merchant's request to cancel {fulfillment_order}, noting {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/cancellation_request/reject.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a cancellation request (2020-01)
      effect: write
      questions:
      - How does a fulfillment service decline a cancellation request on 2020-01?
      - Can I give the merchant a reason for refusing to cancel in the January 2020 API?
      instructions:
      - text: Reject the cancellation request on fulfillment order {fulfillment_order} with 2020-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Via January 2020, refuse to cancel {fulfillment_order} and explain {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/cancellation_request.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Request cancellation of a fulfillment order (2020-04)
      effect: write
      questions:
      - In the 2020-04 Admin API, what call asks a fulfillment service to stop work on a fulfillment order?
      - Is a message optional when requesting cancellation under the April 2020 version?
      instructions:
      - text: Request cancellation of fulfillment order {fulfillment_order} from its service with the 2020-04 endpoint.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: 'Using April 2020, tell the fulfillment service we want {fulfillment_order} cancelled: {message}.'
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/cancellation_request/accept.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a cancellation request (2020-04)
      effect: destructive
      questions:
      - Which April 2020 call lets my fulfillment service accept a cancellation request?
      - Under 2020-04, is a reason optional when I approve a merchant's cancellation?
      instructions:
      - text: Approve the cancellation request for {fulfillment_order} via the 2020-04 endpoint.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Agree to cancel fulfillment order {fulfillment_order} in API April 2020 and tell the merchant {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/cancellation_request/reject.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a cancellation request (2020-04)
      effect: write
      questions:
      - Which 2020-04 endpoint lets my service turn down a merchant's cancellation request?
      - Under April 2020, is there a field for why a cancellation was rejected?
      instructions:
      - text: Decline the cancellation request for {fulfillment_order} using the 2020-04 API.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: On April 2020, reject cancelling fulfillment order {fulfillment_order}, telling the merchant {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/cancellation_request.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Request cancellation of a fulfillment order (2020-07)
      effect: write
      questions:
      - Which 2020-07 endpoint sends a fulfillment service a request to cancel?
      - Can I explain why I'm cancelling when I send the July 2020 cancellation request?
      instructions:
      - text: File a 2020-07 cancellation request against fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Through the July 2020 version, request that {fulfillment_order} be cancelled, with the note {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/cancellation_request/accept.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a cancellation request (2020-07)
      effect: destructive
      questions:
      - What does a fulfillment service call to confirm a cancellation request in the 2020-07 version?
      - In July 2020, can my service explain its acceptance of a cancellation?
      instructions:
      - text: Confirm the 2020-07 cancellation request on fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using July 2020, accept cancelling {fulfillment_order} with the message {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/cancellation_request/reject.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a cancellation request (2020-07)
      effect: write
      questions:
      - What lets a fulfillment service say no to cancelling a fulfillment order in 2020-07?
      - In July 2020, can a rejected cancellation include a message?
      instructions:
      - text: Turn down the 2020-07 cancellation request on fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using July 2020, decline to cancel {fulfillment_order} and reply {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/cancellation_request.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Request cancellation of a fulfillment order
      effect: write
      questions:
      - My app needs the warehouse service to stop fulfilling an order; what do I call on 2020-10?
      - Where do I send a cancellation request to a fulfillment service in the October 2020 API?
      instructions:
      - text: Ask the fulfillment service to cancel fulfillment order {fulfillment_order} (API 2020-10).
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Send an October 2020 cancellation request for {fulfillment_order} with the reason {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/cancellation_request/accept.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a cancellation request
      effect: destructive
      questions:
      - My fulfillment service got a cancellation request; how do I accept it on 2020-10?
      - What endpoint in the October 2020 API approves a merchant's request to cancel?
      instructions:
      - text: Accept the merchant's cancellation request for fulfillment order {fulfillment_order} (2020-10).
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: With October 2020, agree to the cancellation of {fulfillment_order} and reply {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/cancellation_request/reject.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a cancellation request
      effect: write
      questions:
      - How do I refuse a cancellation request as a fulfillment service on 2020-10?
      - Where in the October 2020 API does a service reject a merchant's request to cancel?
      instructions:
      - text: Reject the merchant's cancellation request for fulfillment order {fulfillment_order} (2020-10).
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: 'With October 2020, refuse cancellation of {fulfillment_order}; reason: {message}.'
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillment_orders/{fulfillment_order_id}/cancellation_request.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Request cancellation of a fulfillment order (2021-01)
      effect: write
      questions:
      - With API version 2021-01, can I request that a fulfillment service cancel a fulfillment order?
      - Does the January 2021 cancellation request accept a free-text reason?
      instructions:
      - text: Submit a cancellation request to the service fulfilling {fulfillment_order} on 2021-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Via January 2021, request cancellation for fulfillment order {fulfillment_order} and say {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillment_orders/{fulfillment_order_id}/cancellation_request/accept.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a cancellation request (2021-01)
      effect: destructive
      questions:
      - On API 2021-01, how does a fulfillment service say yes to a cancellation request?
      - Can a January 2021 cancellation acceptance carry a message back to the merchant?
      instructions:
      - text: Say yes to the cancellation request on {fulfillment_order} using version 2021-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: 'Accept, via January 2021, the request to cancel fulfillment order {fulfillment_order}; message: {message}.'
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillment_orders/{fulfillment_order_id}/cancellation_request/reject.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a cancellation request (2021-01)
      effect: write
      questions:
      - On version 2021-01, how does my fulfillment service reject a cancellation request?
      - Does the January 2021 rejection of a cancellation let me explain why?
      instructions:
      - text: Say no to the cancellation request on {fulfillment_order} using 2021-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Via January 2021, decline cancelling fulfillment order {fulfillment_order} with the note {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/{fulfillment_order_id}/cancellation_request.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Request cancellation of a fulfillment order (unstable)
      effect: write
      questions:
      - On the unstable API, which call sends a fulfillment service a cancellation request?
      - Can I include a message with a cancellation request on the unstable version?
      instructions:
      - text: Send an unstable-version cancellation request for fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: 'Using the unstable endpoint, ask the fulfillment service to cancel {fulfillment_order}; reason: {message}.'
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/{fulfillment_order_id}/cancellation_request/accept.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a cancellation request (unstable)
      effect: destructive
      questions:
      - As a fulfillment service on the unstable API, can I accept a merchant's cancellation request?
      - Does the unstable version let me add a note when approving a cancellation?
      instructions:
      - text: Accept the cancellation request for fulfillment order {fulfillment_order} on the unstable version.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using unstable, approve cancelling {fulfillment_order} and send {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/{fulfillment_order_id}/cancellation_request/reject.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a cancellation request (unstable)
      effect: write
      questions:
      - On the unstable API, what's the call to reject a cancellation request?
      - Can the unstable version's cancellation rejection carry a reason for the merchant?
      instructions:
      - text: Reject the cancellation request for fulfillment order {fulfillment_order} on unstable.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using the unstable endpoint, refuse to cancel {fulfillment_order} and say {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/orders/{order_id}/fulfillments/{fulfillment_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a fulfillment on an order (2020-01)
      effect: read
      questions:
      - How do I look up one fulfillment on an order using API 2020-01?
      - Can I limit which fields come back when fetching a fulfillment in January 2020?
      instructions:
      - text: Get fulfillment {fulfillment} on order {order} from the 2020-01 API.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      - text: Using January 2020, show only {fields} for fulfillment {fulfillment} of order {order}.
        slots:
          fields: query.fields
          fulfillment: path.fulfillment_id
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/fulfillments.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Fulfill one or many fulfillment orders (2020-01)
      effect: write
      questions:
      - How do I create a fulfillment covering one or more fulfillment orders in 2020-01?
      - Can a single January 2020 fulfillment span several fulfillment orders?
      instructions:
      - text: Create a fulfillment for my fulfillment orders using the 2020-01 API.
      - text: On January 2020, fulfill several fulfillment orders in one fulfillment.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/fulfillments/{fulfillment_id}/update_tracking.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a fulfillment's tracking (2020-01)
      effect: write
      questions:
      - How do I change the tracking info on a fulfillment using 2020-01?
      - Can I update shipment tracking after a fulfillment is created, in January 2020?
      instructions:
      - text: Update the tracking information for fulfillment {fulfillment} via 2020-01.
        slots:
          fulfillment: path.fulfillment_id
      - text: On January 2020, correct tracking details on fulfillment {fulfillment}.
        slots:
          fulfillment: path.fulfillment_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/orders/{order_id}/fulfillments/{fulfillment_id}/open.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark a fulfillment as open (2020-01)
      effect: write
      questions:
      - How do I mark a fulfillment as open on an order using 2020-01?
      - Can I set a fulfillment's status to open in the January 2020 API?
      instructions:
      - text: Mark fulfillment {fulfillment} on order {order} as open via 2020-01.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      - text: On January 2020, open fulfillment {fulfillment} for order {order}.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/orders/{order_id}/fulfillments/{fulfillment_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a fulfillment on an order (2020-04)
      effect: read
      questions:
      - Which 2020-04 call returns the details of a specific fulfillment?
      - In April 2020, can I fetch just certain fields of an order's fulfillment?
      instructions:
      - text: Retrieve fulfillment {fulfillment} for order {order} via 2020-04.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      - text: On April 2020, fetch fields {fields} of fulfillment {fulfillment} on order {order}.
        slots:
          fields: query.fields
          fulfillment: path.fulfillment_id
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/fulfillments.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Fulfill one or many fulfillment orders (2020-04)
      effect: write
      questions:
      - Which 2020-04 endpoint fulfills items across multiple fulfillment orders at once?
      - In April 2020, can one fulfillment cover more than one fulfillment order?
      instructions:
      - text: Make a fulfillment from fulfillment orders via 2020-04.
      - text: Using April 2020, create one fulfillment that spans multiple fulfillment orders.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/fulfillments/{fulfillment_id}/update_tracking.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a fulfillment's tracking (2020-04)
      effect: write
      questions:
      - Which 2020-04 endpoint updates a fulfillment's tracking info?
      - In April 2020, can I fix the carrier tracking on an existing fulfillment?
      instructions:
      - text: Change tracking info on fulfillment {fulfillment} using 2020-04.
        slots:
          fulfillment: path.fulfillment_id
      - text: Using April 2020, refresh the tracking for fulfillment {fulfillment}.
        slots:
          fulfillment: path.fulfillment_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/orders/{order_id}/fulfillments/{fulfillment_id}/open.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark a fulfillment as open (2020-04)
      effect: write
      questions:
      - Which 2020-04 call sets a fulfillment to open?
      - In April 2020, is there a way to flag an order's fulfillment as open?
      instructions:
      - text: Set fulfillment {fulfillment} of order {order} to open using 2020-04.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      - text: Using April 2020, flag order {order}'s fulfillment {fulfillment} as open.
        slots:
          order: path.order_id
          fulfillment: path.fulfillment_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/orders/{order_id}/fulfillments/{fulfillment_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a fulfillment on an order (2020-07)
      effect: read
      questions:
      - What does the 2020-07 API return for a single fulfillment on an order?
      - Is there a fields filter when I retrieve one fulfillment in July 2020?
      instructions:
      - text: Show me fulfillment {fulfillment} from order {order} using 2020-07.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      - text: Via July 2020, return {fields} for order {order}'s fulfillment {fulfillment}.
        slots:
          fields: query.fields
          order: path.order_id
          fulfillment: path.fulfillment_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/fulfillments.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Fulfill one or many fulfillment orders (2020-07)
      effect: write
      questions:
      - What 2020-07 call marks fulfillment orders fulfilled by creating a new fulfillment?
      - Is it possible in July 2020 to fulfill many fulfillment orders together?
      instructions:
      - text: Record a new fulfillment against fulfillment orders with 2020-07.
      - text: Via July 2020, bundle multiple fulfillment orders into a single fulfillment.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/fulfillments/{fulfillment_id}/update_tracking.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a fulfillment's tracking (2020-07)
      effect: write
      questions:
      - What does the 2020-07 API offer for editing tracking on a fulfillment?
      - Is tracking editable on a fulfillment through July 2020?
      instructions:
      - text: Edit fulfillment {fulfillment}'s tracking with the 2020-07 endpoint.
        slots:
          fulfillment: path.fulfillment_id
      - text: Via July 2020, set new tracking information on fulfillment {fulfillment}.
        slots:
          fulfillment: path.fulfillment_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/orders/{order_id}/fulfillments/{fulfillment_id}/open.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark a fulfillment as open (2020-07)
      effect: write
      questions:
      - What 2020-07 endpoint marks an order's fulfillment open?
      - Is there a July 2020 endpoint to put a fulfillment in the open state?
      instructions:
      - text: Open fulfillment {fulfillment} on order {order} with 2020-07.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      - text: Via July 2020, move fulfillment {fulfillment} of order {order} to open.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/orders/{order_id}/fulfillments/{fulfillment_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a fulfillment on an order
      effect: read
      questions:
      - Where can I check one shipment (fulfillment) on an order with the 2020-10 API?
      - Can I trim the response to a few fields when reading a fulfillment in October 2020?
      instructions:
      - text: Look up fulfillment {fulfillment} on order {order} (API 2020-10).
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      - text: With October 2020, pull only {fields} from fulfillment {fulfillment} of order {order}.
        slots:
          fields: query.fields
          fulfillment: path.fulfillment_id
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/fulfillments.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Fulfill one or many fulfillment orders
      effect: write
      questions:
      - What's the October 2020 way to create a fulfillment for fulfillment orders?
      - Can I fulfill one or many fulfillment orders in a single call on 2020-10?
      instructions:
      - text: Create a fulfillment for one or more fulfillment orders (API 2020-10).
      - text: With October 2020, ship several fulfillment orders as one fulfillment.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/fulfillments/{fulfillment_id}/update_tracking.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a fulfillment's tracking information
      effect: write
      questions:
      - My tracking number was wrong; how do I update it on a fulfillment in 2020-10?
      - Where does October 2020 let me change a fulfillment's tracking information?
      instructions:
      - text: Update tracking for fulfillment {fulfillment} (API 2020-10).
        slots:
          fulfillment: path.fulfillment_id
      - text: With October 2020, replace the tracking details on fulfillment {fulfillment}.
        slots:
          fulfillment: path.fulfillment_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/orders/{order_id}/fulfillments/{fulfillment_id}/open.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark a fulfillment as open
      effect: write
      questions:
      - How can I mark an order's fulfillment as open in version 2020-10?
      - Where in the October 2020 API do I set a fulfillment's status to open?
      instructions:
      - text: Mark order {order}'s fulfillment {fulfillment} as open (API 2020-10).
        slots:
          order: path.order_id
          fulfillment: path.fulfillment_id
      - text: With October 2020, put fulfillment {fulfillment} on order {order} into open status.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/orders/{order_id}/fulfillments/{fulfillment_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a fulfillment on an order (2021-01)
      effect: read
      questions:
      - On version 2021-01, what retrieves a specific fulfillment by its ID?
      - Does January 2021 let me pick which fulfillment fields to return?
      instructions:
      - text: Fetch order {order}'s fulfillment {fulfillment} with 2021-01.
        slots:
          order: path.order_id
          fulfillment: path.fulfillment_id
      - text: Using January 2021, get fulfillment {fulfillment} on order {order}, fields {fields} only.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
          fields: query.fields
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillments.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Fulfill one or many fulfillment orders (2021-01)
      effect: write
      questions:
      - On 2021-01, which endpoint creates a fulfillment from fulfillment orders?
      - Does January 2021 support fulfilling multiple fulfillment orders together?
      instructions:
      - text: Fulfill my fulfillment orders by creating a fulfillment on 2021-01.
      - text: Using January 2021, make a single fulfillment for many fulfillment orders.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillments/{fulfillment_id}/update_tracking.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a fulfillment's tracking (2021-01)
      effect: write
      questions:
      - On version 2021-01, which call updates tracking for a fulfillment?
      - Can I revise fulfillment tracking using January 2021?
      instructions:
      - text: Revise the tracking information of fulfillment {fulfillment} on 2021-01.
        slots:
          fulfillment: path.fulfillment_id
      - text: Using January 2021, update fulfillment {fulfillment} with corrected tracking.
        slots:
          fulfillment: path.fulfillment_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/orders/{order_id}/fulfillments/{fulfillment_id}/open.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark a fulfillment as open (2021-01)
      effect: write
      questions:
      - On 2021-01, what marks a fulfillment open?
      - Can January 2021 flag a specific fulfillment on an order as open?
      instructions:
      - text: Open order {order}'s fulfillment {fulfillment} using 2021-01.
        slots:
          order: path.order_id
          fulfillment: path.fulfillment_id
      - text: Using January 2021, set fulfillment {fulfillment} for order {order} to open.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/orders/{order_id}/fulfillments/{fulfillment_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a fulfillment on an order (unstable)
      effect: read
      questions:
      - Can I read a single fulfillment from an order on the unstable API?
      - Is it possible to request selected fields for a fulfillment on the unstable version?
      instructions:
      - text: Get fulfillment {fulfillment} of order {order} on unstable.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      - text: Using the unstable endpoint, return {fields} for fulfillment {fulfillment} on order {order}.
        slots:
          fields: query.fields
          fulfillment: path.fulfillment_id
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillments.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Fulfill one or many fulfillment orders (unstable)
      effect: write
      questions:
      - Where do I create a fulfillment for fulfillment orders on the unstable API?
      - Can the unstable version fulfill several fulfillment orders in one fulfillment?
      instructions:
      - text: Create a fulfillment from fulfillment orders on the unstable version.
      - text: Using unstable, fulfill multiple fulfillment orders in one go.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillments/{fulfillment_id}/update_tracking.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a fulfillment's tracking (unstable)
      effect: write
      questions:
      - Can I update a fulfillment's tracking info on the unstable API?
      - Does the unstable version support changing tracking after fulfillment?
      instructions:
      - text: Update the tracking for fulfillment {fulfillment} on unstable.
        slots:
          fulfillment: path.fulfillment_id
      - text: Using the unstable endpoint, change tracking information on fulfillment {fulfillment}.
        slots:
          fulfillment: path.fulfillment_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/orders/{order_id}/fulfillments/{fulfillment_id}/open.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark a fulfillment as open (unstable)
      effect: write
      questions:
      - Is marking a fulfillment as open supported on the unstable API?
      - Does the unstable version let me set an order's fulfillment to open?
      instructions:
      - text: Mark fulfillment {fulfillment} of order {order} open on unstable.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      - text: Using the unstable endpoint, open fulfillment {fulfillment} on order {order}.
        slots:
          fulfillment: path.fulfillment_id
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/orders/{order_id}/fulfillment_orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List an order's fulfillment orders (2020-01)
      effect: read
      questions:
      - How do I list the fulfillment orders for an order using 2020-01?
      - Which fulfillment orders belong to an order in the January 2020 API?
      instructions:
      - text: List fulfillment orders for order {order} via 2020-01.
        slots:
          order: path.order_id
      - text: On January 2020, show every fulfillment order attached to order {order}.
        slots:
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a fulfillment order (2020-01)
      effect: read
      questions:
      - How do I retrieve a single fulfillment order by ID in 2020-01?
      - Can I look up one fulfillment order's details with the January 2020 API?
      instructions:
      - text: Get fulfillment order {fulfillment_order} via 2020-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: On January 2020, show details of fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/cancel.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a fulfillment order (2020-01)
      effect: destructive
      questions:
      - How do I cancel a fulfillment order outright using 2020-01?
      - Can I mark a fulfillment order cancelled in the January 2020 API?
      instructions:
      - text: Cancel fulfillment order {fulfillment_order} via 2020-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: On January 2020, mark fulfillment order {fulfillment_order} as cancelled.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/close.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Close a fulfillment order as incomplete (2020-01)
      effect: destructive
      questions:
      - How do I close an in-progress fulfillment order as incomplete using 2020-01?
      - Can I say why a fulfillment order couldn't be completed, in the January 2020 API?
      instructions:
      - text: Close fulfillment order {fulfillment_order} as incomplete via 2020-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: On January 2020, mark in-progress fulfillment order {fulfillment_order} incomplete with the note {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/orders/{order_id}/fulfillment_orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List an order's fulfillment orders (2020-04)
      effect: read
      questions:
      - Which 2020-04 endpoint returns all fulfillment orders on an order?
      - In April 2020, can I see how an order was split into fulfillment orders?
      instructions:
      - text: Get the fulfillment orders of order {order} using 2020-04.
        slots:
          order: path.order_id
      - text: Using April 2020, list order {order}'s fulfillment orders.
        slots:
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a fulfillment order (2020-04)
      effect: read
      questions:
      - Which 2020-04 call fetches one fulfillment order?
      - In April 2020, what reads a specific fulfillment order?
      instructions:
      - text: Retrieve fulfillment order {fulfillment_order} using 2020-04.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using April 2020, look up fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/cancel.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a fulfillment order (2020-04)
      effect: destructive
      questions:
      - Which 2020-04 endpoint marks a fulfillment order as cancelled?
      - In April 2020, can I cancel a fulfillment order directly instead of requesting it?
      instructions:
      - text: Mark fulfillment order {fulfillment_order} cancelled using 2020-04.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using April 2020, cancel the fulfillment order {fulfillment_order} directly.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/close.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Close a fulfillment order as incomplete (2020-04)
      effect: destructive
      questions:
      - Which 2020-04 endpoint marks an in-progress fulfillment order incomplete?
      - In April 2020, is a reason optional when closing a fulfillment order?
      instructions:
      - text: Mark fulfillment order {fulfillment_order} incomplete using 2020-04.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using April 2020, close {fulfillment_order} because {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/orders/{order_id}/fulfillment_orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List an order's fulfillment orders (2020-07)
      effect: read
      questions:
      - What 2020-07 call lists an order's fulfillment orders?
      - Can I pull every fulfillment order for one order with July 2020?
      instructions:
      - text: Show fulfillment orders for order {order} with 2020-07.
        slots:
          order: path.order_id
      - text: Via July 2020, retrieve all fulfillment orders on order {order}.
        slots:
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a fulfillment order (2020-07)
      effect: read
      questions:
      - Where does the 2020-07 API return one fulfillment order?
      - Is there a July 2020 endpoint for a single fulfillment order's details?
      instructions:
      - text: Show fulfillment order {fulfillment_order} with 2020-07.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Via July 2020, fetch the fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/cancel.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a fulfillment order (2020-07)
      effect: destructive
      questions:
      - What 2020-07 call cancels a fulfillment order?
      - Is there a July 2020 call to set a fulfillment order's status to cancelled?
      instructions:
      - text: Cancel fulfillment order {fulfillment_order} with 2020-07.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Via July 2020, set fulfillment order {fulfillment_order} to cancelled.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/close.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Close a fulfillment order as incomplete (2020-07)
      effect: destructive
      questions:
      - As a fulfillment service on 2020-07, what do I call to stop work on a fulfillment order and close it?
      - Can I attach a message when closing a fulfillment order with July 2020?
      instructions:
      - text: Close in-progress fulfillment order {fulfillment_order} with 2020-07.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Via July 2020, flag {fulfillment_order} as incomplete, explaining {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/orders/{order_id}/fulfillment_orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List an order's fulfillment orders
      effect: read
      questions:
      - What fulfillment orders were created for this order, on API 2020-10?
      - Where in October 2020 do I list fulfillment orders for a specific order?
      instructions:
      - text: List all fulfillment orders for order {order} (API 2020-10).
        slots:
          order: path.order_id
      - text: With October 2020, fetch the fulfillment orders belonging to order {order}.
        slots:
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a fulfillment order
      effect: read
      questions:
      - How can I check the status of one fulfillment order on 2020-10?
      - Where does October 2020 let me retrieve a specific fulfillment order?
      instructions:
      - text: Pull up the fulfillment order {fulfillment_order} by ID (API 2020-10).
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: With October 2020, get the details for fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/cancel.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a fulfillment order
      effect: destructive
      questions:
      - How can I cancel a fulfillment order myself on API 2020-10?
      - Where in October 2020 do I mark a fulfillment order as cancelled?
      instructions:
      - text: Cancel fulfillment order {fulfillment_order} outright (API 2020-10).
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: With October 2020, mark {fulfillment_order} as a cancelled fulfillment order.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/close.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Close a fulfillment order as incomplete
      effect: destructive
      questions:
      - How can a fulfillment service close a fulfillment order it can't finish, on 2020-10?
      - Where in October 2020 do I mark an in-progress fulfillment order as incomplete?
      instructions:
      - text: Close fulfillment order {fulfillment_order} as incomplete (API 2020-10).
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: With October 2020, mark {fulfillment_order} incomplete and record {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/orders/{order_id}/fulfillment_orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List an order's fulfillment orders (2021-01)
      effect: read
      questions:
      - On version 2021-01, which call lists fulfillment orders for an order?
      - Does January 2021 return every fulfillment order on an order?
      instructions:
      - text: Retrieve order {order}'s fulfillment orders using 2021-01.
        slots:
          order: path.order_id
      - text: Using January 2021, list fulfillment orders attached to order {order}.
        slots:
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillment_orders/{fulfillment_order_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a fulfillment order (2021-01)
      effect: read
      questions:
      - On 2021-01, what fetches a fulfillment order by its ID?
      - Can January 2021 show me a single fulfillment order?
      instructions:
      - text: Fetch fulfillment order {fulfillment_order} using 2021-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using January 2021, retrieve details of fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillment_orders/{fulfillment_order_id}/cancel.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a fulfillment order (2021-01)
      effect: destructive
      questions:
      - On 2021-01, what marks a fulfillment order cancelled?
      - Can January 2021 cancel a fulfillment order directly?
      instructions:
      - text: Mark fulfillment order {fulfillment_order} as cancelled using 2021-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using January 2021, cancel fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillment_orders/{fulfillment_order_id}/close.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Close a fulfillment order as incomplete (2021-01)
      effect: destructive
      questions:
      - On 2021-01, which call closes a fulfillment order that's in progress?
      - Does January 2021 let me give a reason when marking a fulfillment order incomplete?
      instructions:
      - text: Mark in-progress fulfillment order {fulfillment_order} as incomplete using 2021-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using January 2021, close {fulfillment_order} with the message {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillment_orders/{fulfillment_order_id}/open.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Open a scheduled fulfillment order (2021-01)
      effect: write
      questions:
      - How do I release a scheduled fulfillment order so it's ready to fulfill, on 2021-01?
      - Can I open a scheduled fulfillment order early in the January 2021 API?
      instructions:
      - text: Mark scheduled fulfillment order {fulfillment_order} as ready for fulfillment using 2021-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using January 2021, open the scheduled fulfillment order {fulfillment_order} now.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillment_orders/{fulfillment_order_id}/reschedule.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reschedule a scheduled fulfillment order (2021-01)
      effect: write
      questions:
      - How do I change when a scheduled fulfillment order will be fulfilled, on 2021-01?
      - Can I move the fulfill_at date of a scheduled fulfillment order in January 2021?
      instructions:
      - text: Reschedule fulfillment order {fulfillment_order} using 2021-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using January 2021, update the fulfill-at time on scheduled fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/orders/{order_id}/fulfillment_orders.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List an order's fulfillment orders (unstable)
      effect: read
      questions:
      - Can I list an order's fulfillment orders on the unstable API?
      - Will the unstable version show all fulfillment orders for one order?
      instructions:
      - text: List fulfillment orders for order {order} on unstable.
        slots:
          order: path.order_id
      - text: Using the unstable endpoint, get every fulfillment order of order {order}.
        slots:
          order: path.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/{fulfillment_order_id}.json'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve a fulfillment order (unstable)
      effect: read
      questions:
      - Can I get one fulfillment order on the unstable API?
      - Does the unstable version return a specific fulfillment order by ID?
      instructions:
      - text: Retrieve fulfillment order {fulfillment_order} on unstable.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using the unstable endpoint, show fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/{fulfillment_order_id}/cancel.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a fulfillment order (unstable)
      effect: destructive
      questions:
      - Is cancelling a fulfillment order supported on the unstable API?
      - Does the unstable version let me directly cancel a fulfillment order?
      instructions:
      - text: Cancel fulfillment order {fulfillment_order} on unstable.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using the unstable endpoint, mark fulfillment order {fulfillment_order} cancelled.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/release_hold.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Release holds on an order's fulfillment orders
      effect: write
      questions:
      - How do I release the holds on an order's fulfillment orders using the unstable API?
      - Can I lift fulfillment holds for a specific order on the unstable version?
      instructions:
      - text: Release fulfillment order holds for order {order} on unstable.
        slots:
          order: query.order_id
      - text: Using the unstable endpoint, remove the holds so order {order} can be fulfilled.
        slots:
          order: query.order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/{fulfillment_order_id}/close.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Close a fulfillment order as incomplete (unstable)
      effect: destructive
      questions:
      - Can I close a fulfillment order as incomplete on the unstable API?
      - Will the unstable version record why a fulfillment order was closed?
      instructions:
      - text: Close fulfillment order {fulfillment_order} on unstable.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using the unstable endpoint, mark {fulfillment_order} incomplete, noting {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/{fulfillment_order_id}/open.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Open a scheduled fulfillment order (unstable)
      effect: write
      questions:
      - On the unstable API, what makes a scheduled fulfillment order ready for fulfillment?
      - Does the unstable version let me open a scheduled fulfillment order ahead of its date?
      instructions:
      - text: Open scheduled fulfillment order {fulfillment_order} on unstable.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using the unstable endpoint, mark {fulfillment_order} ready to be fulfilled.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/{fulfillment_order_id}/reschedule.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reschedule a scheduled fulfillment order (unstable)
      effect: write
      questions:
      - On the unstable API, which call reschedules a scheduled fulfillment order?
      - Does the unstable version let me push back a fulfillment order's fulfill_at time?
      instructions:
      - text: Reschedule scheduled fulfillment order {fulfillment_order} on unstable.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using the unstable endpoint, change the fulfill_at time for {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a fulfillment request (2020-01)
      effect: write
      questions:
      - How do I send a fulfillment order to its fulfillment service for processing, using 2020-01?
      - Can I request fulfillment for only some line items in the January 2020 API?
      instructions:
      - text: Send a fulfillment request for fulfillment order {fulfillment_order} via 2020-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: On January 2020, ask the service to fulfill {line_items} of {fulfillment_order}, with the note {message}.
        slots:
          line_items: query.fulfillment_order_line_items
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a fulfillment request (2020-01)
      effect: write
      questions:
      - Once a merchant sends my service a fulfillment request, how do I accept it via 2020-01?
      - Can I include a note when accepting a fulfillment request in the January 2020 API?
      instructions:
      - text: Accept the fulfillment request on fulfillment order {fulfillment_order} via 2020-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: On January 2020, take on fulfillment order {fulfillment_order} and reply {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a fulfillment request (2020-01)
      effect: write
      questions:
      - As a fulfillment service on 2020-01, what's the call to turn down a merchant's request to fulfill an order?
      - Can I tell the merchant why I'm refusing to fulfill, in the January 2020 API?
      instructions:
      - text: Reject the fulfillment request on fulfillment order {fulfillment_order} via 2020-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: On January 2020, decline to fulfill {fulfillment_order} and explain {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a fulfillment request (2020-04)
      effect: write
      questions:
      - Which 2020-04 endpoint submits a fulfillment request to a fulfillment service?
      - In April 2020, if I leave out line items, is the whole fulfillment order requested?
      instructions:
      - text: Request fulfillment of {fulfillment_order} from its fulfillment service using 2020-04.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using April 2020, submit line items {line_items} of fulfillment order {fulfillment_order} for fulfillment.
        slots:
          line_items: query.fulfillment_order_line_items
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a fulfillment request (2020-04)
      effect: write
      questions:
      - Which 2020-04 endpoint lets a fulfillment service agree to fulfill a request?
      - In April 2020, is a message optional when I accept a fulfillment request?
      instructions:
      - text: Accept the 2020-04 fulfillment request for {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using April 2020, agree to fulfill {fulfillment_order}, noting {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a fulfillment request (2020-04)
      effect: write
      questions:
      - Which 2020-04 endpoint lets my service refuse a fulfillment request?
      - Under April 2020, is there a field for the reason I won't fulfill?
      instructions:
      - text: Refuse to fulfill {fulfillment_order} using the 2020-04 API.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: On April 2020, reject the request to fulfill fulfillment order {fulfillment_order}, telling the merchant {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a fulfillment request (2020-07)
      effect: write
      questions:
      - What 2020-07 call hands off a fulfillment order to its fulfillment service?
      - Can I include a message to the fulfillment service with a July 2020 fulfillment request?
      instructions:
      - text: Submit a 2020-07 fulfillment request for fulfillment order {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Via July 2020, request fulfillment of {fulfillment_order} and tell the service {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a fulfillment request (2020-07)
      effect: write
      questions:
      - What does my service call to confirm it will fulfill an order through the 2020-07 API?
      - Can July 2020's fulfillment request acceptance carry a message?
      instructions:
      - text: Confirm the fulfillment request on {fulfillment_order} with 2020-07.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Via July 2020, accept fulfilling fulfillment order {fulfillment_order} with the message {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a fulfillment request (2020-07)
      effect: write
      questions:
      - Which 2020-07 call lets my warehouse service turn away a merchant's fulfillment request?
      - Does July 2020 let me say why I'm rejecting a request to fulfill?
      instructions:
      - text: Reject fulfillment order {fulfillment_order}'s fulfillment request through 2020-07.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Via July 2020, refuse the fulfillment work on {fulfillment_order} with note {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a fulfillment request to a fulfillment service
      effect: write
      questions:
      - How can I ask my fulfillment service to start fulfilling an order, on 2020-10?
      - Where in October 2020 do I send a fulfillment request for selected line items?
      instructions:
      - text: Send fulfillment order {fulfillment_order} to its fulfillment service (API 2020-10).
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: With October 2020, request fulfillment of only {line_items} on {fulfillment_order}.
        slots:
          line_items: query.fulfillment_order_line_items
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a fulfillment request
      effect: write
      questions:
      - A merchant asked my service to fulfill an order; how do I accept on 2020-10?
      - Where in October 2020 does a service accept a merchant's request to fulfill?
      instructions:
      - text: Accept the merchant's fulfillment request for {fulfillment_order} (API 2020-10).
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: With October 2020, agree to fulfill fulfillment order {fulfillment_order} and say {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a fulfillment request
      effect: write
      questions:
      - My service can't ship an order; how do I reject its fulfillment request on 2020-10?
      - Which October 2020 endpoint declines fulfillment requests?
      instructions:
      - text: Reject the merchant's fulfillment request for {fulfillment_order} (2020-10).
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: 'With October 2020, decline fulfilling {fulfillment_order}; reason: {message}.'
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a fulfillment request (2021-01)
      effect: write
      questions:
      - On 2021-01, which call sends a fulfillment request to a fulfillment service?
      - Does January 2021 let me request fulfillment for part of a fulfillment order?
      instructions:
      - text: Request fulfillment for fulfillment order {fulfillment_order} using 2021-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using January 2021, send line items {line_items} of {fulfillment_order} to the fulfillment service, noting {message}.
        slots:
          line_items: query.fulfillment_order_line_items
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a fulfillment request (2021-01)
      effect: write
      questions:
      - On 2021-01, how does a fulfillment service accept a fulfillment request?
      - Does January 2021 let my service send a message when it accepts fulfillment?
      instructions:
      - text: Say yes to the fulfillment request on {fulfillment_order} using 2021-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: 'Using January 2021, accept fulfilling {fulfillment_order}; message: {message}.'
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a fulfillment request (2021-01)
      effect: write
      questions:
      - Using 2021-01, what do I call to decline fulfilling a fulfillment order I was sent?
      - Can a January 2021 rejection of a fulfillment request carry a reason?
      instructions:
      - text: Say no to fulfilling {fulfillment_order} using 2021-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Via January 2021, reject the fulfillment request on {fulfillment_order} with the note {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/{fulfillment_order_id}/fulfillment_request.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a fulfillment request (unstable)
      effect: write
      questions:
      - Is sending a fulfillment request possible on the unstable API?
      - Can the unstable version request fulfillment of specific line items only?
      instructions:
      - text: Send a fulfillment request for {fulfillment_order} on unstable.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using the unstable endpoint, ask the service to fulfill {line_items} from {fulfillment_order}.
        slots:
          line_items: query.fulfillment_order_line_items
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/accept.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Accept a fulfillment request (unstable)
      effect: write
      questions:
      - Which unstable-API call accepts a fulfillment request?
      - Can the unstable version's fulfillment acceptance include a note?
      instructions:
      - text: Accept the fulfillment request for {fulfillment_order} on unstable.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using the unstable endpoint, agree to fulfill {fulfillment_order} and send {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/{fulfillment_order_id}/fulfillment_request/reject.json'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a fulfillment request (unstable)
      effect: write
      questions:
      - How do I reject a fulfillment request on the unstable API?
      - Can the unstable version's rejection of a fulfillment request include a reason?
      instructions:
      - text: Reject the fulfillment request for {fulfillment_order} on unstable.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: On unstable, decline fulfillment order {fulfillment_order}'s request, explaining {message}.
        slots:
          fulfillment_order: path.fulfillment_order_id
          message: query.message
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-01/fulfillment_orders/{fulfillment_order_id}/locations_for_move.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations a fulfillment order can move to (2020-01)
      effect: read
      questions:
      - Which locations can a fulfillment order be moved to, in API 2020-01?
      - How do I find where I could relocate a fulfillment order using January 2020?
      instructions:
      - text: List locations fulfillment order {fulfillment_order} could move to via 2020-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: On January 2020, show possible new locations for {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-04/fulfillment_orders/{fulfillment_order_id}/locations_for_move.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations a fulfillment order can move to (2020-04)
      effect: read
      questions:
      - In 2020-04, what locations are available to move a fulfillment order to?
      - Can I check candidate locations before moving a fulfillment order, with April 2020?
      instructions:
      - text: Get move-to locations for fulfillment order {fulfillment_order} using 2020-04.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using April 2020, find where {fulfillment_order} can be reassigned.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-07/fulfillment_orders/{fulfillment_order_id}/locations_for_move.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations a fulfillment order can move to (2020-07)
      effect: read
      questions:
      - What 2020-07 call lists locations for moving a fulfillment order?
      - Is there a July 2020 call showing which warehouses could take over a fulfillment order?
      instructions:
      - text: Show locations that could take fulfillment order {fulfillment_order}, using 2020-07.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Via July 2020, list move destinations for {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2020-10/fulfillment_orders/{fulfillment_order_id}/locations_for_move.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations a fulfillment order can move to
      effect: read
      questions:
      - Where could this fulfillment order be fulfilled from instead, on 2020-10?
      - Which October 2020 endpoint lists locations a fulfillment order can potentially move to?
      instructions:
      - text: List potential locations to move fulfillment order {fulfillment_order} (API 2020-10).
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: With October 2020, show which locations {fulfillment_order} can be moved to.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/2021-01/fulfillment_orders/{fulfillment_order_id}/locations_for_move.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations a fulfillment order can move to (2021-01)
      effect: read
      questions:
      - On 2021-01, how do I see locations a fulfillment order could be moved to?
      - Can January 2021 tell me eligible locations for relocating a fulfillment order?
      instructions:
      - text: Retrieve locations for moving {fulfillment_order} using 2021-01.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using January 2021, list where fulfillment order {fulfillment_order} could be relocated.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/api/unstable/fulfillment_orders/{fulfillment_order_id}/locations_for_move.json'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations a fulfillment order can move to (unstable)
      effect: read
      questions:
      - Can I list locations for moving a fulfillment order on the unstable API?
      - Does the unstable version show where a fulfillment order can move?
      instructions:
      - text: Get locations for move for fulfillment order {fulfillment_order} on unstable.
        slots:
          fulfillment_order: path.fulfillment_order_id
      - text: Using the unstable endpoint, list possible locations for {fulfillment_order}.
        slots:
          fulfillment_order: path.fulfillment_order_id
      method: generated
      generated: '2026-09-24'