> ## Documentation Index > Fetch the complete documentation index at: https://developer.zeeg.me/llms.txt > Use this file to discover all available pages before exploring further. # Handover a Scheduled Event > Reassign a scheduled Round Robin event from its current host to another eligible host in your workspace. ## OpenAPI ````yaml PUT /scheduled-events/{uuid}/handover openapi: 3.0.0 info: title: Zeeg Public API description: >- Zeeg public API documentation. ## Authentication All endpoints require a Bearer token. You can generate an API token from [your Zeeg dashboard](https://app.zeeg.me/account/settings/api-access). Each token is scoped to specific permissions (e.g. `events:read`, `webhooks:write`). Make sure your token has the required scopes for the endpoints you want to use. ## Recommended Headers We recommend including the `Accept: application/json` header in all API requests to ensure you receive JSON responses. version: 2.0.0 x-logo: url: https://app.zeeg.me/img/logo-dark.2ca83593.svg backgroundColor: '#f7f7f9' altText: zeeg contact: name: Zeeg Support email: support@zeeg.me url: https://zeeg.me/en/contact license: name: Proprietary url: https://zeeg.me/en/legal/terms termsOfService: https://zeeg.me/en/legal/terms servers: - url: https://api.zeeg.me/v2 description: Production security: - bearer: [] tags: - name: Scheduled Events description: Management of events scheduled via Zeeg - name: Scheduling Pages description: Scheduling pages information and management - name: Availability Schedule description: Read and change availability for users - name: Webhooks description: Webhooks management - name: Notes description: Notes for scheduled events - name: Workspaces & Teams description: Workspace users and team member management - name: AI Agent description: AI Agent integration endpoints - name: Payloads description: Webhook payload schemas - name: CRM - Objects description: >- Discover the schema of CRM objects (standard and custom) including all attribute definitions - name: CRM - Companies description: Create, read, update, and delete CRM company records - name: CRM - People description: Create, read, update, and delete CRM person records paths: /scheduled-events/{uuid}/handover: parameters: - schema: type: string format: uuid example: zg-O69bac566950c6 name: uuid in: path required: true description: UUID of a specific scheduled event (zg-XXX format) put: tags: - Scheduled Events summary: Handover a scheduled event description: >- This endpoint allows you to handover a scheduled event identified by its unique **UUID** to another host in the event type for Round Robin without changing the meeting links. - The new host must be a member of the event type hosts; however, you can let the system automatically pick an available host by not providing `newHostEmail` in the request. - Host availability can be ignored by setting `requireHostAvailability` to `false`; please note that this means the new host will get overlapping events. - Handover can fall back on the rescheduling process with the selected host if `fallbackToReschedule` is set to `true`. #### Current limitation This endpoint currently works only under the following conditions: - Supports only Round Robin events. - The event must be synchronized to either a Microsoft calendar OR no calendar. - The location must NOT be Zoom or Webex. Other locations are supported. operationId: put-api-scheduled-events-uuid-handover requestBody: description: '' content: application/json: schema: type: object properties: newHostEmail: type: string description: >- The email of the new host for the event. When not provided, the system will automatically select a new host if available. format: email example: marco.rossi@horizondigital.de requireHostAvailability: type: boolean description: A flag to check the availability of the host. default: false fallbackToReschedule: type: boolean description: >- A flag indicating whether the event should be rescheduled if the current settings are not supported. default: true examples: Handing over to a specific host without requiring availability: value: newHostEmail: marco.rossi@horizondigital.de requireHostAvailability: false fallbackToReschedule: true responses: '200': description: OK content: application/json: schema: type: object properties: resource: $ref: '#/components/schemas/ScheduledEvent' examples: Successful event handover: value: resource: uri: >- https://api.zeeg.me/v2/scheduled-events/zg-O69bac566950c6 uuid: zg-O69bac566950c6 title: 30-Minute Discovery Call type: ROUND_ROBIN startTime: '2026-04-15T09:00:00.000000Z' endTime: '2026-04-15T09:30:00.000000Z' duration: 30 status: active eventTypeUri: >- https://api.zeeg.me/v2/event-types/80f46bf5-eb01-4c07-960e-a9a3e18aae5e location: null maxActiveInvitees: 1 activeInviteesCount: 1 invitees: - uuid: zg-O69bad4047abf0 salutation: Ms. fullName: Sophie Laurent email: sophie.laurent@northwind.io guests: [] timeZone: Europe/Paris cancellation: cancelledAt: null cancelledBy: null cancellerType: null cancellationReason: null payment: null scheduledAt: '2026-04-10T08:30:00.000000Z' utm: utm_campaign: spring_launch utm_source: linkedin utm_medium: social utm_content: null utm_term: null customQueryParams: [] guests: [] hosts: - firstName: Marco lastName: Rossi email: marco.rossi@horizondigital.de slug: marco-rossi url: https://zeeg.me/marco-rossi avatarUrl: null createdAt: '2026-04-10T08:30:00.000000Z' updatedAt: '2026-04-15T10:05:00.000000Z' currentTime: '2026-04-15T10:05:00+00:00' '400': description: Bad Request content: application/json: schema: type: object properties: success: type: boolean message: type: string status: type: integer examples: Not a Round Robin event: value: success: false message: events.not_round_robin status: 400 Host not found: value: success: false message: Host not found. status: 400 Same host selected: value: success: false message: The selected host is the same as the current event host. status: 400 '401': $ref: '#/components/responses/401' '500': description: Internal Server Error content: application/json: schema: type: object properties: success: type: boolean message: type: string status: type: integer examples: Event not found: value: success: false message: Event not found status: 500 security: - bearer: [] components: schemas: ScheduledEvent: type: object required: - uri - uuid - title - type - startTime - endTime - duration - status - eventTypeUri - maxActiveInvitees - activeInviteesCount - invitees - createdAt properties: uri: type: string format: uri description: Public API URI of the scheduled event resource. uuid: type: string description: Zeeg event identifier (zg-XXX format) example: zg-O69bac566950c6 title: type: string description: Title of the scheduled event. type: type: string description: Event type kind (e.g. `ONE_ON_ONE`, `GROUP`, `ROUND_ROBIN`). startTime: type: string format: date-time description: ISO 8601 UTC start time of the booked event. endTime: type: string format: date-time description: ISO 8601 UTC end time of the booked event. duration: type: integer description: Event duration in minutes. status: type: string description: Booking status (e.g. `confirmed`, `cancelled`). eventTypeUri: type: string format: uri description: Public API URI of the event type this booking was made against. location: type: object nullable: true required: - type properties: type: type: string description: >- Location type (e.g. `google_meet`, `zoom`, `phone`, `in_person`). joinUrl: type: string format: uri description: Join URL for the meeting, when applicable. nullable: true description: Meeting location for the booking. maxActiveInvitees: type: integer description: Maximum number of active invitees the event allows. activeInviteesCount: type: integer description: Current number of active (non-cancelled) invitees. invitees: type: array items: type: object required: - fullName - email - timeZone - scheduledAt properties: uuid: type: string description: Zeeg attendee identifier (zg-XXX format) example: zg-O69bac566950c6 salutation: type: string nullable: true description: Salutation for the invitee, if collected. fullName: type: string description: Full name of the invitee. nullable: true email: type: string format: email description: Email address of the invitee. nullable: true guests: type: array description: Array of additional emails invited nullable: true items: type: string timeZone: type: string description: IANA time zone of the invitee. nullable: true cancellation: type: object properties: cancelledAt: type: string format: date-time nullable: true description: ISO 8601 UTC timestamp when the invitee was cancelled. cancelledBy: type: string nullable: true description: Identifier of who cancelled the booking. cancellerType: type: string nullable: true description: Type of canceller (e.g. host, invitee). cancellationReason: type: string nullable: true description: Reason given for the cancellation. description: >- Cancellation details. All fields are `null` when the invitee is not cancelled. payment: type: object nullable: true description: >- Payment details for the booking, or `null` when no payment applies. properties: gateway: type: string description: Payment provider, e.g. `stripe` or `paypal`. price: type: number currency: type: string transactionId: type: string nullable: true createdAt: type: string format: date-time status: type: string enum: - pending - success description: '`pending` until the transaction completes.' scheduledAt: type: string format: date-time description: ISO 8601 UTC timestamp when the invitee booked. nullable: true utm: type: object properties: utm_campaign: type: string nullable: true utm_source: type: string nullable: true utm_medium: type: string nullable: true utm_content: type: string nullable: true utm_term: type: string nullable: true description: UTM tracking parameters captured at booking time. customQueryParams: type: array items: {} description: Custom query parameters captured at booking time. questions: type: array nullable: true items: type: object properties: answer: type: string answer_type: type: string question: type: string description: Booking questions answered by the invitee. agentBookingReference: type: string nullable: true description: >- Reference code for bookings made via the AI agent; `null` otherwise. description: Invitees booked on the scheduled event. guests: type: array description: Array of additional emails invited nullable: true items: type: string hosts: type: array nullable: true items: type: object required: - firstName - email - slug - url properties: firstName: type: string description: Host's first name. nullable: true lastName: type: string description: Host's last name. Empty string when not set. email: type: string format: email description: Host's email address. nullable: true slug: type: string description: Host's public profile slug. nullable: true url: type: string format: uri description: Host's public profile URL. avatarUrl: type: string format: uri nullable: true description: URL of the host's avatar image, if set. description: Hosts assigned to the scheduled event. createdAt: type: string format: date-time description: ISO 8601 UTC timestamp when the booking was created. updatedAt: type: string format: date-time description: ISO 8601 UTC timestamp when the booking was last updated. currentTime: type: string format: date-time description: Current server time description: >- 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. responses: '401': description: Unauthorized content: application/json: schema: type: object properties: message: type: string example: Unauthenticated. examples: Unauthenticated: value: message: Unauthenticated. securitySchemes: bearer: type: http scheme: bearer description: '' ````