Skip to main content
PUT

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"

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 and no overrideLevel opens the time: 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.

overrideLevel
enum<integer>

Hands the booking to a host who is not free at the booking's time, as far as the level allows. Without it, the new host must be free. A handover ignores buffers and minimum notice at every level, and booking limits for a named newHostEmail.

  • 1: only hosts who are free (the same as leaving it out).
  • 2: also hosts whose working hours, time off or booking window block the time.
  • 3: also hosts whose connected calendar has an entry at that time.
  • 4: no availability check on the host: also hosts with another Zeeg booking at that time, so the host is double-booked.

Without newHostEmail, a free host is picked by the round-robin rules; when none is free, the host the time is least blocked for gets the booking, as far as the level allows. It never goes back to the current host. Needs a token whose user may edit the scheduling page; otherwise the call returns 403. A host the level does not open returns 400.

Available options:
1,
2,
3,
4
Example:

2

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