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:false

A flag to check the availability of the host.

fallbackToReschedule
boolean
default:true

A flag indicating whether the event should be rescheduled if the current settings are not supported.

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