---
title: "DELETE /events/by-slug/{slug}"
method: DELETE
path: "/events/by-slug/{slug}"
---

# DELETE /events/by-slug/{slug}

`DELETE /events/by-slug/{slug}`

## Request

- Base URL: `https://docs.theeventscalendar.com/index.php?rest_route=/tribe/events/v1`
- URL: `https://docs.theeventscalendar.com/index.php?rest_route=/tribe/events/v1/events/by-slug/{slug}`
- Auth: none declared

## Path parameters

- `slug` string, required

## Response `200`

Deletes an event and returns its data

- Event
  - `id` integer: The event WordPress post ID
  - `global_id` string: The event ID used to globally identify in Event Aggregator
  - `global_id_lineage` string[]: An Array containing the lineage of where this event comes from, this should not change after the event is created.
  - `author` integer: The event author WordPress post ID
  - `date` string: The event creation date in the site time zone
  - `date_utc` string: The event creation date in UTC time
  - `modified` string: The event last modification date in the site time zone
  - `modified_utc` string: The event last modification date in UTC time
  - `status` string: The event status
  - `url` string: The URL to the event page
  - `rest_url` string: The TEC REST API link to fetch this event
  - `title` string: The event name
  - `description` string: The event long description
  - `excerpt` string: The event short description
  - `slug` string: The event slug
  - `image` Image
    - `url` string, uri: The URL to the full size version of the image
    - `id` integer: The image WordPress post ID
    - `extension` string: The image file extension
    - `width` integer: The image natural width in pixels
    - `height` integer: The image natural height in pixels
    - `sizes` ImageSize[]: The details about each size available for the image
      - `width` integer: The image width in pixels in the specified size
      - `height` integer: The image height in pixels in the specified size
      - `mime-type` string: The image mime-type
      - `url` string, uri: The link to the image in the specified size on the site
  - `all_day` boolean: Whether or not this event is an all day Event
  - `start_date` string: The event start date in the event or site time zone
  - `start_date_details` DateDetails[]: An array of each component of the event start date
    - `year` integer: The date year
    - `month` integer: The date month
    - `day` integer: The date day
    - `hour` integer: The date hour
    - `minutes` integer: The date minutes
    - `seconds` integer: The date seconds
  - `end_date` string: The event end date in the event or site time zone
  - `end_date_details` DateDetails[]: An array of each component of the event end date
    - `year` integer: The date year
    - `month` integer: The date month
    - `day` integer: The date day
    - `hour` integer: The date hour
    - `minutes` integer: The date minutes
    - `seconds` integer: The date seconds
  - `utc_start_date` string: The event start date in UTC time
  - `utc_start_date_details` DateDetails[]: An array of each component of the event start date in UTC time
    - `year` integer: The date year
    - `month` integer: The date month
    - `day` integer: The date day
    - `hour` integer: The date hour
    - `minutes` integer: The date minutes
    - `seconds` integer: The date seconds
  - `utc_end_date` string: The event end date in UTC time
  - `utc_end_date_details` DateDetails[]: An array of each component of the event end date in UTC time
    - `year` integer: The date year
    - `month` integer: The date month
    - `day` integer: The date day
    - `hour` integer: The date hour
    - `minutes` integer: The date minutes
    - `seconds` integer: The date seconds
  - `timezone` string: The event time zone string
  - `timezone_abbr` string: The abbreviated event time zone string
  - `cost` string: The event cost including the currency symbol
  - `cost_details` CostDetails[]: The event cost details
    - `currency_symbol` string: The cost currency symbol
    - `currency_position ` 'prefix' | 'postfix': The position of the currency symbol in the cost string
    - `values` integer[]: A sorted array of all the numeric values for the cost
  - `website` string: The event website URL
  - `show_map` boolean: Whether the map should be shown for the event or not
  - `show_map_link` boolean: Whether the map link should be shown for the event or not
  - `hide_from_listings` boolean: Whether an event should be hidden from the calendar view or not
  - `sticky` boolean: Whether an event is sticky in the calendar view or not
  - `featured` boolean: Whether the event is featured in the calendar or not
  - `categories` Term[]: The event categories
    - `id` integer: The WordPress term ID
    - `name` string: The term name
    - `slug` string: The term slug
    - `taxonomy` string: The taxonomy the term belongs to
    - `description` string: The term description
    - `parent` integer: The term parent term if any
    - `count` integer: The number of posts associated with the term
    - `url` string: The URL to the term archive page
    - `urls` string[]: A list of links to the term own, archive and parent REST URL
  - `tags` Term[]: The event tags
    - `id` integer: The WordPress term ID
    - `name` string: The term name
    - `slug` string: The term slug
    - `taxonomy` string: The taxonomy the term belongs to
    - `description` string: The term description
    - `parent` integer: The term parent term if any
    - `count` integer: The number of posts associated with the term
    - `url` string: The URL to the term archive page
    - `urls` string[]: A list of links to the term own, archive and parent REST URL
  - `venue` Venue
    - `id` integer: The venue WordPress post ID
    - `global_id` string: The venue ID used to globally identify in Event Aggregator
    - `global_id_lineage` string[]: An Array containing the lineage of where this organizer comes from, this should not change after the organizer is created.
    - `author` integer: The venue author WordPress post ID
    - `date` string: The venue creation date in the site time zone
    - `date_utc` string: The venue creation date in UTC time
    - `modified` string: The venue last modification date in the site time zone
    - `modified_utc` string: The venue last modification date in UTC time
    - `status` string: The venue status
    - `url` string: The URL to the venue page
    - `venue` string: The venue name
    - `description` string: The venue long description
    - `excerpt` string: The venue short description
    - `slug` string: The venue slug
    - `image` Image
      - `url` string, uri: The URL to the full size version of the image
      - `id` integer: The image WordPress post ID
      - `extension` string: The image file extension
      - `width` integer: The image natural width in pixels
      - `height` integer: The image natural height in pixels
      - `sizes` ImageSize[]: The details about each size available for the image
        - `width` integer: The image width in pixels in the specified size
        - `height` integer: The image height in pixels in the specified size
        - `mime-type` string: The image mime-type
        - `url` string, uri: The link to the image in the specified size on the site
    - `show_map` boolean: Whether the map should be shown for the venue or not
    - `show_map_link` boolean: Whether the map link should be shown for the venue or not
    - `address` string: The venue address
    - `city` string: The venue city
    - `country` string: The venue country
    - `province` string: The venue province
    - `state` string: The venue state
    - `zip` string: The venue ZIP code
    - `phone` string: The venue phone number
    - `website` string: The venue website URL
    - `stateprovince` string: The venue state or province
    - `geo_lat` number, double: The venue geo latitude
    - `geo_lng` number, double: The venue geo longitude
  - `organizer` Organizer[]: The event organizers
    - `id` integer: The organizer WordPress post ID
    - `global_id` string: The organizer ID used to globally identify in Event Aggregator
    - `global_id_lineage` string[]: An Array containing the lineage of where this organizer comes from, this should not change after the organizer is created.
    - `author` integer: The organizer author WordPress post ID
    - `date` string: The organizer creation date in the site time zone
    - `date_utc` string: The organizer creation date in UTC time
    - `modified` string: The organizer last modification date in the site time zone
    - `modified_utc` string: The organizer last modification date in UTC time
    - `status` string: The organizer status
    - `url` string: The URL to the organizer page
    - `organizer` string: The organizer name
    - `description` string: The organizer long description
    - `excerpt` string: The organizer short description
    - `slug` string: The organizer slug
    - `image` Image
      - `url` string, uri: The URL to the full size version of the image
      - `id` integer: The image WordPress post ID
      - `extension` string: The image file extension
      - `width` integer: The image natural width in pixels
      - `height` integer: The image natural height in pixels
      - `sizes` ImageSize[]: The details about each size available for the image
        - `width` integer: The image width in pixels in the specified size
        - `height` integer: The image height in pixels in the specified size
        - `mime-type` string: The image mime-type
        - `url` string, uri: The link to the image in the specified size on the site
    - `phone` string: The organizer phone number
    - `website` string: The organizer website
    - `email` string: The organizer email address

## Other responses

- `400`: The event post ID is missing or does not exist.
- `403`: The current user cannot delete the event with the specified ID.
- `410`: The event with the specified ID has been deleted already.
- `500`: The event with the specified ID could not be deleted.

---

[API](https://skmtc.dev/theeventscalendar/apis/the-events-calendar-rest-api.md) - [All operations](https://skmtc.dev/theeventscalendar/apis/the-events-calendar-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/theeventscalendar/apis/the-events-calendar-rest-api/revisions/ec2e0a6a611b?raw)
