reassign_booking

This reference is generated from the published tool contract.

Behavior and boundaries

Hands a booking over to another member, e.g. a substitute during an absence. Ridian creates the event in the new host’s calendar with a new meeting link (Meet, Teams or Zoom), then deletes the old event, emails the booker the new host and link (with a Google or Microsoft calendar the new host’s calendar also sends a new invitation and cancels the old one; otherwise the email carries an updated calendar file), notifies the new host and moves the lead owner. For round robin, omit to_user_id to pick the next free host. Group bookings move together. Course bookings cannot be handed over. Confirm with the user first.

Permissions

Granted scopes, accounts, calendars and visibility rules limit access. Workspace administrators do not automatically gain access to other users’ accounts.

bookings:write

Consent and boundaries

Input

{
  "$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."
    },
    "to_user_id": {
      "description": "New host. Omit for round robin to pick the next free host.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "from_user_id": {
      "description": "Collective only: which host to replace. Default: the booking's host.",
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    }
  },
  "required": [
    "booking_id"
  ],
  "additionalProperties": false
}

Output

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "booking_id": {
      "type": "string"
    },
    "reassigned": {
      "type": "boolean"
    },
    "new_host_user_id": {
      "type": "string"
    },
    "booking_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "console_url": {
      "type": "string"
    }
  },
  "required": [
    "booking_id",
    "reassigned",
    "new_host_user_id",
    "booking_ids",
    "console_url"
  ],
  "additionalProperties": false
}

Errors and retries

Check the tool result for errors. Do not blindly retry writes after a timeout. Check the current resource or send status first.

Error handling