> ## 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.

# Delete a Scheduling Page

> Delete a scheduling page for good. Its link stops working and the voice agent routes that book it are removed; existing bookings stay.



## OpenAPI

````yaml DELETE /event-types/{uuid}
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.


    ## Responses

    Every response is JSON, whatever `Accept` header the request sends.
  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:
  /event-types/{uuid}:
    parameters:
      - schema:
          type: string
          format: uuid
        name: uuid
        in: path
        required: true
        description: UUID of a specific scheduling page
    delete:
      tags:
        - Scheduling Pages
      summary: Delete a scheduling page
      description: >-
        Deletes a scheduling page as the dashboard does. It cannot be undone.
        Its booking link stops working at once, and with it go the voice agent
        routes that book the page (the response lists them), the routing form
        routes that send invitees to it (a fallback route shows its default
        message instead) and the workflows' pending messages for its bookings.
        Existing bookings stay.


        To take a page offline without deleting it, deactivate it with `PUT
        /event-types/{uuid}/status`. Requires the `event_types:write` scope, and
        is refused while impersonating a user.


        An event page with fixed dates (`schedulingMode: fixed_dates`) also
        removes its future dates nobody registered for. When a future date has
        registrations, send `datesWithRegistrations`: `cancel` cancels those
        dates and notifies their invitees, `keep` keeps them. Without it such a
        page answers 422 and nothing is deleted. Every other page ignores the
        parameter. `cancel` cancels bookings, so it also needs the
        `events:write` scope, as every other cancellation does.
      operationId: delete-api-event-type
      parameters:
        - in: query
          name: datesWithRegistrations
          required: false
          description: >-
            What happens to an event page's future dates that have
            registrations. `cancel` also needs the `events:write` scope.
          schema:
            type: string
            enum:
              - cancel
              - keep
      responses:
        '200':
          description: Deleted.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  status:
                    type: integer
                  data:
                    type: object
                    properties:
                      uuid:
                        type: string
                      title:
                        type: string
                      removedAgentRoutes:
                        type: array
                        description: >-
                          The voice agent routes that booked this page and were
                          removed with it.
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            agentId:
                              type: string
                            agentName:
                              type: string
                              nullable: true
              examples:
                Deleted with one voice agent route:
                  value:
                    success: true
                    status: 200
                    data:
                      uuid: 3f8a1c2d-5b6e-4f7a-9c0d-1e2f3a4b5c6d
                      title: Intro call
                      removedAgentRoutes:
                        - id: 6b2c9e1f-3a4d-4e5f-8a7b-1c2d3e4f5a6b
                          agentId: 2e4f6a8c-1b3d-4f5a-9c7e-0d2f4a6c8e1b
                          agentName: Front desk
        '401':
          $ref: '#/components/responses/401'
        '403':
          description: >-
            Your role does not allow this page to be deleted, the token is used
            while impersonating a user, or the token lacks a scope the call
            needs. `datesWithRegistrations=cancel` needs `events:write` beside
            `event_types:write`.
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/SchedulingPageWriteError'
                  - type: object
                    properties:
                      error:
                        type: object
                        properties:
                          type:
                            type: string
                          message:
                            type: string
                          error_id:
                            type: string
                          required_scopes:
                            type: array
                            items:
                              type: string
              examples:
                Missing scope:
                  value:
                    error:
                      type: insufficient_scope
                      message: 'Your token is missing the required scope: events:write.'
                      error_id: 5d1e8a3b-7c2f-4e9a-b6d0-3f8c1a2e4b7d
                      required_scopes:
                        - events:write
        '404':
          description: The page does not exist or is not one you may manage.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              examples:
                Scheduling page not found:
                  value:
                    error: Entry for EventType not found
        '422':
          description: >-
            An event page has future dates with registrations and
            `datesWithRegistrations` is missing, or it holds another value than
            `cancel` or `keep`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SchedulingPageWriteError'
      security:
        - bearer: []
components:
  responses:
    '401':
      description: Unauthorized
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Unauthenticated.
          examples:
            Unauthenticated:
              value:
                message: Unauthenticated.
  schemas:
    SchedulingPageWriteError:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        status:
          type: integer
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: ''

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.