cancel_booking

Diese Referenz wird aus dem veröffentlichten Werkzeugvertrag erzeugt. Feldnamen und normative Beschreibungen im Schema sind Englisch.

Verhalten und Grenzen

Sagt eine Buchung als Gastgeber ab. Ridian löscht den Kalendereintrag und informiert die buchende Person per E-Mail, mit Grund, falls angegeben. Nicht rückgängig zu machen; vorher mit dem Nutzer bestätigen.

Berechtigungen

Freigegebene Scopes, Konten, Kalender und Sichtbarkeitsregeln begrenzen den Zugriff. Ein Workspace-Admin erhält dadurch keinen pauschalen Zugriff auf fremde Konten.

bookings:write

Freigaben und Grenzen

Eingabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "booking_id from list_bookings."
    },
    "reason": {
      "description": "Shown to the booker in the cancellation email.",
      "type": "string",
      "maxLength": 1000
    }
  },
  "required": [
    "booking_id"
  ],
  "additionalProperties": false
}

Ausgabe

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string"
    },
    "cancelled": {
      "type": "boolean"
    },
    "calendar": {
      "type": "string"
    }
  },
  "required": [
    "booking_id",
    "cancelled",
    "calendar"
  ],
  "additionalProperties": false
}

Fehler und Wiederholungen

Prüfe das Werkzeugergebnis auf Fehler. Wiederhole Schreiboperationen nicht blind nach einem Timeout. Prüfe zuerst den aktuellen Ressourcen- oder Sendestatus.

Fehlerbehandlung