---
title: "Delete an Event"
method: DELETE
path: "/v1/events"
tags: ["Events"]
---

# Delete an Event

`DELETE /v1/events`

## Request

- Base URL: `https://api.exhibitday.com`
- URL: `https://api.exhibitday.com/v1/events`
- Auth: one of:
  - API key in header `api_key`
  - API key in query parameter `api_key`

Permanently deletes an event. It cannot be undone.

Documentation: https://api.exhibitday.com/Help/V1?epf=1#delete-v1-events

## Query parameters

- `id` integer, required

## Response `200`

OK

- StatusResponse, nullable
  - `status_code` integer
  - `status` string, nullable
  - `message` string, nullable
  - `errors` string[], nullable
  - `warnings` string[], nullable: Only when an empty value left a parameter unchanged (see the help page).
  - `error_code` string, nullable: Errors only: what kind of error this is. invalid_request (400): A parameter is missing or has an invalid value (error_params names it when the API can tell); malformed_json (400): The request body is not valid JSON; not_allowed (400): The change is not allowed for that record in ExhibitDay (e.g., the event's tasks or its deletion are locked, or its Misc. Expenses & Credits tab is hidden); idempotency_key_reused (400): The Idempotency-Key was already used with a different request. Use a new key for a new request; missing_api_key (401): No api_key was sent; invalid_api_key (401): The api_key is not valid; api_access_disabled (401): API access is not enabled for the workspace; not_found (404): No record with that id exists in your workspace; unknown_endpoint (404): The URL or HTTP method is not part of the API; idempotency_key_in_use (409): A request with the same Idempotency-Key is still being processed. Retry after a moment; idempotency_key_indeterminate (409): A previous request with this Idempotency-Key did not finish and its outcome is unknown, so this retry was not run (to avoid creating a duplicate). Check whether the earlier request succeeded; to try again, use a new Idempotency-Key; rate_limited (429): Too many requests. Wait the number of seconds in the Retry-After header, then retry; internal_error (500): An unexpected error occurred. Quote the request_id when you contact support. New codes may be added; handle an unknown code by its HTTP status.
  - `error_params` string[], nullable: Errors only: the request parameters the errors refer to ([] when the API cannot tell).
  - `request_id` string, nullable: Errors only: this request's id, also in the X-Request-Id header. Quote it when you contact support.

## Other responses

- `400`: Bad Request: a missing or invalid parameter, or a change that is not allowed (error_code says which).
- `401`: Unauthorized: the api_key is missing or invalid, or API access is not enabled for the workspace.
- `404`: Not Found: no object with that id in your workspace, or an unknown URL or method.
- `429`: Too Many Requests: the rate limit was exceeded.
- `500`: Unexpected Internal Error.

---

[API](https://skmtc.dev/exhibitday/apis/exhibitday-api.md) · [All operations](https://skmtc.dev/exhibitday/apis/exhibitday-api/llms.txt) · [OpenAPI document](https://skmtc.dev/exhibitday/apis/exhibitday-api/revisions/a35e95422b0a?raw)