> ## 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. # Reschedule a Scheduled Event > Move a booking to a new date and time. The invitee and the host receive a reschedule notice, and the response names the new identifiers. ## OpenAPI ````yaml PUT /scheduled-events/{uuid}/reschedule 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 - name: Routing Forms - Forms description: Read routing forms with their questions and their routes - name: Routing Forms - Submissions description: Read and delete the submissions that invitees send through a routing form paths: /scheduled-events/{uuid}/reschedule: 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: Reschedule a scheduled event description: >- Move a booking to a new date and time. This endpoint exists on v2 only — v1 has no reschedule endpoint. Only the new slot is accepted. The invitee's name, email, phone, guests and question answers all carry over from the existing booking unchanged; the request cannot rewrite whose booking it is. A reschedule never preserves booking identity. Every scheduling page type (one-on-one, round robin, group, collective, flexi) gets a new booking with a new event `uuid` and a new invitee `uuid`; the old booking is torn down. The response names the resulting identifiers explicitly — do not assume the `uuid` you sent still refers to the live booking after this call succeeds. Call `GET /scheduled-events/{uuid}/reschedule-availability` first to discover which slots this endpoint accepts for a given booking. It runs the same slot computation this endpoint writes against, so the slots it returns are exactly the slots this endpoint accepts. operationId: put-api-scheduled-event-reschedule requestBody: content: application/json: schema: type: object required: - date - start properties: date: type: string format: date description: New booking date, in `YYYY-MM-DD` format. example: '2026-04-22' start: type: string description: >- New start time, in `HH:mm` 24-hour format (in the given `timeZone`). example: '14:30' timeZone: type: string nullable: true description: >- IANA time zone for `date`/`start`. Defaults to the existing invitee's time zone when omitted. example: Europe/Paris duration: type: integer nullable: true minimum: 1 description: >- New duration in minutes. The event type ignores an unsupported value and uses its own configured duration instead. reason: type: string nullable: true maxLength: 512 description: Optional reason for the reschedule. examples: Reschedule to a later slot: value: date: '2026-04-22' start: '14:30' timeZone: Europe/Paris reason: Requested a later slot. responses: '200': description: OK content: application/json: schema: type: object required: - resource properties: resource: $ref: '#/components/schemas/ScheduledEvent' examples: Successful reschedule: value: resource: uri: >- https://api.zeeg.me/v2/scheduled-events/zg-O69bf1a2b3c4d5 uuid: zg-O69bf1a2b3c4d5 title: 30-Minute Discovery Call type: ONE_ON_ONE startTime: '2026-04-22T12:30:00.000000Z' endTime: '2026-04-22T13:00:00.000000Z' duration: 30 status: confirmed eventTypeUri: >- https://api.zeeg.me/v2/event-types/80f46bf5-eb01-4c07-960e-a9a3e18aae5e location: type: Google Meet joinUrl: https://meet.google.com/abc-defg-hij maxActiveInvitees: 1 activeInviteesCount: 1 invitees: - uuid: zg-O69bf6d7e8f901 salutation: Ms. fullName: Sophie Laurent email: sophie.laurent@northwind.io guests: - alex.chen@northwind.io timeZone: Europe/Paris cancellation: cancelledAt: null cancelledBy: null cancellerType: null cancellationReason: null payment: null questions: - answer: Product demo and pricing options answer_type: STRING question: What would you like to discuss? noShow: false noShowAt: null scheduledAt: '2026-04-17T10:00:00.000000Z' utm: utm_campaign: spring_launch utm_source: linkedin utm_medium: social utm_content: null utm_term: null customQueryParams: {} cancelUrl: https://zeeg.me/cancel/zg-O69bf6d7e8f901 rescheduleUrl: https://zeeg.me/reschedule/zg-O69bf6d7e8f901 rescheduled: false rescheduling: oldStartAt: '2026-04-15T09:00:00.000000Z' newStartAt: '2026-04-22T12:30:00.000000Z' rescheduledAt: '2026-04-17T10:00:00.000000Z' previousEventUuid: zg-O69bac566950c6 previousInviteeUuid: zg-O69bad4047abf0 reason: Requested a later slot. rescheduledBy: user reschedulerFullName: Lena Meier nextRescheduling: null guests: - alex.chen@northwind.io hosts: - firstName: Lena lastName: Meier email: lena.meier@horizondigital.de slug: lena-meier url: https://zeeg.me/lena-meier avatarUrl: null teamName: Sales createdAt: '2026-04-17T10:00:00.000000Z' updatedAt: '2026-04-17T10:00:00.000000Z' currentTime: '2026-04-17T10:00:00+00:00' '400': description: Bad Request content: application/json: schema: type: object properties: success: type: boolean message: type: string status: type: integer examples: Already cancelled: value: success: false message: Event has already been cancelled! status: 400 Already rescheduled: value: success: false message: The event has been already rescheduled. status: 400 Booking in the past: value: success: false message: The event is in the past. status: 400 Slot no longer available: value: success: false message: >- The requested time slot is not available for rescheduling. Please select another time. status: 400 '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: object properties: type: type: string message: type: string error_id: type: string examples: Missing or invalid token: value: error: type: unauthenticated message: A valid API token is required to access this resource. error_id: 3d3a9f2b-6c1d-4b8a-9e2f-7a5c1e0d4b6a '403': description: Forbidden content: application/json: schema: oneOf: - type: object description: >- The caller cannot update this booking (fails the ownership/team/organization gate). properties: success: type: boolean message: type: string status: type: integer - type: object description: The token is missing the `events:write` scope. properties: error: type: object properties: type: type: string message: type: string error_id: type: string required_scopes: type: array items: type: string examples: Cannot update booking: value: success: false message: You don't have permission to view this event. status: 403 Missing scope: value: error: type: insufficient_scope message: 'Your token is missing the required scope: events:write.' error_id: 3197be5d-c4fb-4488-a607-8422caf536e6 required_scopes: - events:write '404': description: Not Found content: application/json: schema: type: object properties: error: type: object properties: type: type: string message: type: string error_id: type: string examples: Event not found: value: error: type: not_found message: Entry for Event not found. error_id: a15b5b16-02c6-423b-be78-48627f4b80fe '422': description: Unprocessable Entity content: application/json: schema: type: object properties: message: type: string errors: type: object additionalProperties: type: array items: type: string examples: Missing required fields: value: message: The Date field is required. (and 1 more error) errors: date: - The Date field is required. start: - The Start field is required. security: - bearer: [] components: schemas: ScheduledEvent: type: object required: - uri - uuid - title - type - startTime - endTime - duration - status - eventTypeUri - maxActiveInvitees - activeInviteesCount - invitees - teamName - 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 - noShow 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: >- Email addresses of additional guests the invitee added. An empty array when the invitee added none. 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.' noShow: type: boolean description: >- Whether the invitee has been marked as a no-show. Always present. noShowAt: type: string format: date-time nullable: true description: >- ISO 8601 UTC timestamp when the invitee was marked as a no-show, or `null` when they were not. scheduledAt: type: string format: date-time description: ISO 8601 UTC timestamp when the invitee booked. nullable: true utm: type: object required: - utm_campaign - utm_source - utm_medium - utm_term - utm_content 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. Always holds these five keys, in `snake_case`; a key holds `null` when the booking did not carry a value for it. adAttribution: type: object nullable: true properties: gclid: type: string nullable: true description: Google Ads click ID. gbraid: type: string nullable: true description: >- Google click ID for iOS app-to-web clicks. Mutually exclusive with `gclid` per click. wbraid: type: string nullable: true description: >- Google click ID for web-to-app clicks. Mutually exclusive with `gclid` per click. fbclid: type: string nullable: true description: Meta click ID. fbp: type: string nullable: true description: Meta browser ID cookie (`_fbp`) captured at booking time. fbc: type: string nullable: true description: Meta click cookie (`_fbc`) captured at booking time. landingUrl: type: string nullable: true description: >- Full URL of the host page the booking widget was embedded on. description: >- Ad-click identifiers captured at booking time, keyed by provider. Only the keys that were actually captured are present; `null` when none were captured. customQueryParams: type: object description: >- Custom query parameters captured at booking time, keyed by the `c__`-prefixed parameter name. An empty object when the booking captured none. example: c__ref: nl-2026-04 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. cancelUrl: type: string format: uri nullable: true description: >- Public URL the invitee uses to cancel this booking. `null` once the booking is cancelled. rescheduleUrl: type: string format: uri nullable: true description: >- Public URL the invitee uses to reschedule this booking. `null` once the booking is cancelled. rescheduled: type: boolean description: >- True once this booking has been superseded by a reschedule. A rescheduled booking reports `status: cancelled` for backward compatibility; `rescheduled` and `nextRescheduling` are how a caller tells a reschedule apart from an actual cancellation. rescheduling: allOf: - $ref: '#/components/schemas/EventRescheduling' nullable: true description: >- Present when this booking is the *result* of a reschedule. `null` when this booking was not itself created by rescheduling an earlier one. nextRescheduling: allOf: - $ref: '#/components/schemas/EventRescheduling' nullable: true description: >- Present when this booking has been superseded by a later reschedule. `null` when the booking has not been rescheduled. description: Invitees booked on the scheduled event. guests: type: array description: >- Email addresses of additional guests added across all invitees. An empty array when none were added. 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. teamName: type: string nullable: true description: >- Name of the team that owns the scheduling page the booking was made on, or `null` for a personal scheduling page. The key is always present. This is the same value the `invitee.scheduled` webhook sends as `teamName` for the same booking. example: Sales 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. EventRescheduling: type: object description: >- Links one half of a reschedule to the other. Embedded as `rescheduling` (on the new booking) and `nextRescheduling` (on the superseded booking) inside an invitee. properties: oldStartAt: type: string format: date-time nullable: true description: >- ISO 8601 UTC start time the previous booking held before the reschedule. newStartAt: type: string format: date-time nullable: true description: ISO 8601 UTC start time the new booking was moved to. rescheduledAt: type: string format: date-time description: ISO 8601 UTC timestamp when the reschedule was performed. previousEventUuid: type: string nullable: true description: >- uuid of the superseded booking (zg-XXX format). Use it directly as the `uuid` path parameter of `GET /scheduled-events/{uuid}` to fetch that booking. example: zg-O69bad4047abf0 previousInviteeUuid: type: string nullable: true description: >- uuid of the invitee on the superseded booking. No public endpoint accepts an invitee uuid as a path parameter. example: zg-O69bac566950c6 reason: type: string nullable: true description: Reason given for the reschedule, if any. rescheduledBy: type: string nullable: true description: Who performed the reschedule (e.g. `host`, `invitee`). reschedulerFullName: type: string nullable: true description: Full name of the person who performed the reschedule, when known. securitySchemes: bearer: type: http scheme: bearer description: '' ````