---
updatedAt: 2026-10-05T21:33:06.000Z
agentTools:
  projectIndex: https://developer.duda.co/llms.txt
---

# Cancel an appointment

Cancels the appointment with the given UID and frees its slot for rebooking. When no appointment with this UID exists the API returns 400 with error_code ResourceNotExist; cancelling an already cancelled appointment returns 400.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Duda Partner API",
    "version": "1.0.0",
    "description": "REST API for Duda partners. Manage accounts, sites, content, collections, eCommerce, bookings, memberships and webhooks on the Duda platform."
  },
  "servers": [
    {
      "url": "https://api.duda.co",
      "description": "Production (US)"
    },
    {
      "url": "https://api.eu.duda.co",
      "description": "Production (EU)"
    },
    {
      "url": "https://api-sandbox.duda.co",
      "description": "Sandbox"
    }
  ],
  "security": [
    {
      "basicAuth": []
    }
  ],
  "paths": {
    "/api/sites/multiscreen/{site_name}/booking/appointments/{appointment_uid}/cancel": {
      "post": {
        "tags": [
          "Native booking appointments api"
        ],
        "summary": "Cancel an appointment",
        "description": "Cancels the appointment with the given UID and frees its slot for rebooking. When no appointment with this UID exists the API returns 400 with error_code ResourceNotExist; cancelling an already cancelled appointment returns 400.",
        "operationId": "cancelAppointment",
        "parameters": [
          {
            "$ref": "#/components/parameters/SiteName"
          },
          {
            "$ref": "#/components/parameters/AppointmentUid"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ApiCancelAppointmentRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiAppointmentResponse"
                }
              }
            }
          },
          "400": {
            "description": "Non-OK response from the server",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiErrorResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized request - missing or invalid credentials"
          },
          "429": {
            "description": "Rate limit exceeded - please refer to api documentation for limits"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ApiAppointmentResponse": {
        "type": "object",
        "properties": {
          "absent_host": {
            "type": "boolean",
            "description": "Whether the host is absent",
            "example": false
          },
          "appointment_type": {
            "$ref": "#/components/schemas/ApiEventType"
          },
          "attendees": {
            "type": "array",
            "description": "Appointment attendees",
            "example": [
              {
                "absent": false,
                "email": "user@multiscreensite.com",
                "language": "en",
                "name": "Default",
                "timeZone": "Asia/Jerusalem"
              }
            ],
            "items": {
              "$ref": "#/components/schemas/ApiSeatedAttendee"
            }
          },
          "booking_fields_responses": {
            "type": "object",
            "description": "Booking fields responses",
            "example": {
              "email": "user@multiscreensite.com",
              "guests": [],
              "name": "Default"
            }
          },
          "cancellation_reason": {
            "type": "string",
            "description": "Cancellation reason",
            "example": "Schedule conflict"
          },
          "cancelled_by_email": {
            "type": "string",
            "description": "Email of the user who cancelled the appointment",
            "example": "user@multiscreensite.com"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Creation timestamp",
            "example": "2025-06-16T14:31:58.794Z"
          },
          "description": {
            "type": "string",
            "description": "Appointment description"
          },
          "duration": {
            "type": "number",
            "description": "Appointment duration in minutes",
            "example": 30
          },
          "end": {
            "type": "string",
            "description": "Appointment end time",
            "example": "2025-06-16T18:00:00.000Z"
          },
          "hosts": {
            "type": "array",
            "description": "Appointment hosts",
            "example": [
              {
                "email": "staffmember1@multiscreensite.com",
                "id": "1582498",
                "name": "Staff Member 1",
                "time_zone": "Asia/Jerusalem",
                "username": "staffmember1-example-com"
              }
            ],
            "items": {
              "$ref": "#/components/schemas/ApiBookingHost"
            }
          },
          "ics_uid": {
            "type": "string",
            "description": "ICS UID",
            "example": "kko1gv8tFZe8JjpCpct5tG@duda.co"
          },
          "id": {
            "type": "integer",
            "format": "int64",
            "description": "Appointment ID",
            "example": 8589828
          },
          "location": {
            "type": "string",
            "description": "Appointment location",
            "example": "https://app.example.com/video/kko1gv8tFZe8JjpCpct5tG"
          },
          "metadata": {
            "type": "object",
            "description": "Metadata stored with the appointment: what the caller supplied, plus the appointment-type, pricing and `bookingSource` fields the product itself writes",
            "example": {
              "pricingType": "FREE",
              "source": "qa-test"
            }
          },
          "rating": {
            "type": "number",
            "description": "Appointment rating",
            "example": 5
          },
          "recurring_booking_uid": {
            "type": "string",
            "description": "Recurring booking UID",
            "example": "rec_kko1gv8tFZe8JjpCpct5tG"
          },
          "rescheduled_by_email": {
            "type": "string",
            "description": "Email of the user who rescheduled the appointment",
            "example": "user@multiscreensite.com"
          },
          "rescheduled_from_uid": {
            "type": "string",
            "description": "UID of the previous appointment from which this booking was rescheduled",
            "example": "abc123defGHIjkl456MNO"
          },
          "rescheduling_reason": {
            "type": "string",
            "description": "Rescheduling reason",
            "example": "Availability changed"
          },
          "start": {
            "type": "string",
            "description": "Appointment start time",
            "example": "2025-06-16T17:30:00.000Z"
          },
          "status": {
            "$ref": "#/components/schemas/AppointmentStatus"
          },
          "title": {
            "type": "string",
            "description": "Appointment title",
            "example": "Sample Event between Staff Member 1 and Default"
          },
          "uid": {
            "type": "string",
            "description": "Appointment UID",
            "example": "kko1gv8tFZe8JjpCpct5tG"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Last update timestamp",
            "example": "2025-06-16T14:31:59.219Z"
          }
        }
      },
      "ApiBookingHost": {
        "type": "object",
        "description": "Appointment hosts",
        "example": {
          "email": "staffmember1@multiscreensite.com",
          "id": "1582498",
          "name": "Staff Member 1",
          "time_zone": "Asia/Jerusalem",
          "username": "staffmember1-example-com"
        },
        "properties": {
          "email": {
            "type": "string",
            "description": "Host email",
            "example": "staffmember1@multiscreensite.com"
          },
          "id": {
            "type": "string",
            "description": "Host ID",
            "example": "1582498"
          },
          "name": {
            "type": "string",
            "description": "Host name",
            "example": "Staff Member 1"
          },
          "time_zone": {
            "type": "string",
            "description": "Host timezone",
            "example": "Asia/Jerusalem"
          },
          "username": {
            "type": "string",
            "description": "Host username",
            "example": "staffmember1-example-com"
          }
        }
      },
      "ApiCancelAppointmentRequest": {
        "type": "object",
        "properties": {
          "cancellation_reason": {
            "type": "string",
            "description": "Optional reason shared with the host and the attendee in the cancellation email.",
            "example": "Schedule conflict"
          }
        }
      },
      "ApiErrorResponse": {
        "type": "object",
        "properties": {
          "error_code": {
            "$ref": "#/components/schemas/ErrorCode"
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BusinessErrorDetail"
            }
          },
          "message": {
            "type": "string"
          }
        }
      },
      "ApiEventType": {
        "type": "object",
        "description": "Appointment type",
        "properties": {
          "id": {
            "type": "string",
            "description": "Event type ID",
            "example": "2660601"
          },
          "slug": {
            "type": "string",
            "description": "Event type slug",
            "example": "sample-event"
          }
        }
      },
      "ApiSeatedAttendee": {
        "type": "object",
        "description": "Appointment attendees",
        "example": {
          "name": "Default",
          "email": "user@multiscreensite.com",
          "time_zone": "Asia/Jerusalem",
          "language": "en",
          "absent": false
        },
        "properties": {
          "absent": {
            "type": "boolean",
            "description": "Whether the attendee is absent",
            "example": false
          },
          "booking_fields_responses": {
            "type": "object",
            "description": "Booking fields responses",
            "example": {
              "email": "user@multiscreensite.com",
              "name": "Default"
            }
          },
          "email": {
            "type": "string",
            "description": "Attendee email",
            "example": "user@multiscreensite.com"
          },
          "language": {
            "$ref": "#/components/schemas/BookingLanguageEnum"
          },
          "metadata": {
            "type": "object",
            "description": "Metadata",
            "example": {}
          },
          "name": {
            "type": "string",
            "description": "Attendee name",
            "example": "Default"
          },
          "phone_number": {
            "type": "string",
            "description": "Attendee phone number",
            "example": "+1234567890"
          },
          "seat_uid": {
            "type": "string",
            "description": "Seat UID",
            "example": "seat_abc123"
          },
          "time_zone": {
            "type": "string",
            "description": "Attendee timezone",
            "example": "Asia/Jerusalem"
          }
        }
      },
      "AppointmentStatus": {
        "type": "string",
        "description": "Appointment status",
        "enum": [
          "accepted",
          "cancelled",
          "pending",
          "rejected"
        ],
        "example": "accepted"
      },
      "BookingLanguageEnum": {
        "type": "string",
        "description": "Attendee preferred language for confirmation emails.",
        "enum": [
          "en",
          "fr",
          "it",
          "ru",
          "es",
          "de",
          "pt",
          "ro",
          "nl",
          "pt-BR",
          "es-419",
          "ko",
          "ja",
          "pl",
          "ar",
          "iw-TL",
          "zh-HK",
          "zh-CN",
          "zh-TW",
          "cs",
          "sr",
          "sv",
          "no",
          "fi",
          "da",
          "he",
          "tr",
          "uk",
          "vi",
          "hu",
          "id",
          "ms",
          "th",
          "sk",
          "bg",
          "hr",
          "lt",
          "sl",
          "hi",
          "et",
          "lv",
          "el",
          "ca"
        ]
      },
      "BusinessErrorDetail": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "ErrorCode": {
        "type": "string",
        "enum": [
          "AccessForbidden",
          "ResourceNotExist",
          "ResourceAlreadyExist",
          "InvalidInput",
          "InvalidState",
          "InternalError",
          "UnAuthorized",
          "TooManyRequests",
          "InsufficientCredits"
        ]
      }
    },
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "description": "API username and password. Find them in the API access section of the Business tools tab in the platform.",
        "scheme": "basic"
      }
    },
    "parameters": {
      "SiteName": {
        "name": "site_name",
        "in": "path",
        "description": "The site's unique name (its ID), returned when the site is created.",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "AppointmentUid": {
        "name": "appointment_uid",
        "in": "path",
        "description": "The appointment's unique ID.",
        "required": true,
        "schema": {
          "type": "string"
        }
      }
    }
  }
}
```