> ## Documentation Index
> Fetch the complete documentation index at: https://cal.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete an Event

> Removes an Event, its registrations and its occurrence booking. An upcoming published Event is cancelled first, notifying its guests, and disappears from listings immediately; it is permanently removed once those notices have gone out. An Event cancelled more than seven days earlier is removed at once. An ended Event that still has confirmed guests cannot be deleted, and a published paid Event cannot be deleted because its payment records are retained. The authenticated user must be its owner, one of its hosts, or a member of the owning team; an external co-host gets 404. PBAC permission for team events: `calEvent.delete`. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the `EVENT_WRITE` scope is required.



## OpenAPI

````yaml /api-reference/v2/openapi.json delete /v2/events/{uuid}
openapi: 3.0.0
info:
  title: Cal.com API v2
  description: ''
  version: 1.0.0
  contact: {}
servers: []
security: []
tags: []
paths:
  /v2/events/{uuid}:
    delete:
      tags:
        - Events
      summary: Delete an Event
      description: >-
        Removes an Event, its registrations and its occurrence booking. An
        upcoming published Event is cancelled first, notifying its guests, and
        disappears from listings immediately; it is permanently removed once
        those notices have gone out. An Event cancelled more than seven days
        earlier is removed at once. An ended Event that still has confirmed
        guests cannot be deleted, and a published paid Event cannot be deleted
        because its payment records are retained. The authenticated user must be
        its owner, one of its hosts, or a member of the owning team; an external
        co-host gets 404. PBAC permission for team events: `calEvent.delete`.
        Learn more about API access control at
        https://cal.com/docs/api-reference/v2/access-control. If accessed using
        an OAuth access token, the `EVENT_WRITE` scope is required.
      operationId: EventsController_delete
      parameters:
        - name: uuid
          required: true
          in: path
          description: >-
            Event UUID. Accepts the canonical UUID (e.g.
            `018ff5cd-6dc4-7d57-bcbc-374702ca8b38`) or its short-uuid (Flickr
            Base58) form (e.g. `1cbZYoAFoJdwqN4tixezd5`).
          schema:
            type: string
            format: uuid
        - name: Authorization
          in: header
          description: >-
            value must be `Bearer <token>` where `<token>` is api key prefixed
            with cal_, managed user access token, or OAuth access token
          required: true
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteEventOutputResponseDto'
        '400':
          description: Invalid Event UUID, or the Event must be cancelled first
        '401':
          description: Unauthenticated
        '403':
          description: Insufficient permissions
        '404':
          description: Event not found
components:
  schemas:
    DeleteEventOutputResponseDto:
      type: object
      properties:
        status:
          enum:
            - success
            - error
          type: string
          example: success
        data:
          $ref: '#/components/schemas/DeleteEventOutputDto'
      required:
        - status
        - data
    DeleteEventOutputDto:
      type: object
      properties:
        uuid:
          type: string
          description: Unique identifier of the deleted Event.
      required:
        - uuid

````

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