Skip to main content
PUT
Handover a scheduled event

Authorizations

Authorization
string
header
required

Path Parameters

uuid
string<uuid>
required

UUID of a specific scheduled event (zg-XXX format)

Example:

"zg-O69bac566950c6"

Body

application/json
newHostEmail
string<email>

The email of the new host for the event. When not provided, the system will automatically select a new host if available.

Example:

"marco.rossi@horizondigital.de"

requireHostAvailability
boolean
default:true

Only hand the booking to a host who is free at the event time. When false, the new host receives the booking whether or not the slot is free.

fallbackToReschedule
boolean
default:false

When the booking cannot move in place (it sits in a calendar other than Microsoft, or its location is Zoom, Webex or Demodesk), reschedule it to the new host at the same time instead of failing the call. It does not apply when the new host is busy: with requireHostAvailability set to true, that call fails either way. This path goes through a reschedule, so the booking gets a new event uuid and a new invitee uuid. Leave it false to keep the identifiers the caller already holds.

Response

OK

resource
object

A scheduled event resource. This is the single canonical shape returned by all scheduled-event endpoints and embedded in the AI agent call webhook payload.

Last modified on April 29, 2026