action viator_merchant_cancellation {
  label: "/merchant/cancellation"
  description: "Cancel a booking\n**Note**: This service has been replaced by the [cancellationReasons](#operation/cancellationReasons), [bookingQuote](#operation/bookingQuote) and [cancelBooking](#operation/cancelBooking) endpoints\n"
  provider: viator
  method: POST
  path: "/merchant/cancellation"
  encoding: json
  input: {
    type: "object"
    properties: {
      cancelItems: {
        type: "array"
        description: "**array** of objects detailing itinerary items to cancel"
        items: {
          type: "object"
          properties: {
            cancelCode: {
              type: "string"
              description: "**cancellation code** that describes the reason for the cancellation\n- see: [Suggested cancellation codes](#suggested-cancellation-codes)\n"
            }
            cancelDescription: {
              type: "string"
              description: "**natural-language description** of the reason for cancellation (a reason must be provided if `cancelCode` is `62` or `66`)"
            }
            distributorItemRef: {
              type: "string"
              description: "**alphanumeric reference code** of the distributor item"
            }
            itemId: {
              type: "integer"
              description: "**numeric identifier** of item to cancel in itinerary"
            }
          }
        }
      }
      distributorRef: {
        type: "string"
        description: "**itinerary reference identifier** (partner defined) for the booking to cancel"
      }
      itineraryId: {
        type: "integer"
        description: "**numeric identifier** for the itinerary"
      }
    }
  }
  output: {
    type: "object"
  }
}