action viator_cancel_booking {
  label: "/bookings/{booking-reference}/cancel"
  description: "Submits a cancellation request for the specified booking\n\nFor information on how to use this service, see: [Cancellation API workflow](#section/Common-workflows-and-data-validation/Cancellation-API-workflow)\n\n**Note**: \n\n  * This service <u>requires</u> [exp-api-key](#section/Authentication/exp-api-key) to be included as a header parameter. Please speak to your account manager if you have not yet been issued an exp-api-key.\n  * The base URL for the server for this endpoint is different from the older endpoints described in this document. Use `https://api.sandbox.viator.com/partner/bookings/{booking-reference}/cancel`\n"
  provider: viator
  method: POST
  path: "/bookings/{booking-reference}/cancel"
  encoding: json
  input: {
    type: "object"
    properties: {
      "booking-reference": {
        type: "string"
      }
      reasonCode: {
        type: "string"
        description: "Machine-interpretable identification code for this cancellation reason, retrieved from [cancellationReasons](#operation/cancellationReasons)"
      }
    }
    required: ["booking-reference"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      bookingId: {
        type: "string"
        description: "Booking reference number for this booking, prepended with `BR-`"
      }
      reason: {
        type: "string"
        enum: ["ALREADY_CANCELLED", "NOT_CANCELLABLE"]
      }
      status: {
        type: "string"
        description: "String indicating the outcome of the booking cancellation request.\n\n  * `ACCEPTED`: The cancellation was successful\n  * `DECLINED`: The cancellation failed\n"
        enum: ["ACCEPTED", "DECLINED"]
      }
    }
  }
}