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

# Delete Event

> Soft-delete an event

# Delete Event

Soft-deletes an event. The event is hidden from the dashboard, its public page, and the [List Events](/api-reference/events/list-events) endpoint. The underlying record is kept, so the id stays reserved and historical reporting is unaffected.

**Only the primary host organization can delete an event.** An event your organization merely co-hosts is not visible to your key and returns `404`.

Deleting does **not** refund tickets or notify attendees — cancel the event from the dashboard first if attendees must be told or refunded.

Deleting an event that is already deleted returns `200` again; the call is idempotent.

Requires the `events:write` scope.

## Path Parameters

<ParamField path="eventId" type="string" required>
  The unique identifier of the event.
</ParamField>

## Response

Returns `200 OK` with:

```json theme={null}
{ "deleted": true, "id": "AbCdEfGhIjKlMnOpQrSt" }
```

## Errors

* `404 Event not found` — the event does not exist, or is not owned by your organization (including events you co-host).
* `403 insufficient_scope` — the API key does not have `events:write`.

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE -H "X-API-KEY: your_api_key" \
    https://www.gomry.com/api/v1/events/AbCdEfGhIjKlMnOpQrSt
  ```

  ```javascript JavaScript theme={null}
  await fetch("https://www.gomry.com/api/v1/events/AbCdEfGhIjKlMnOpQrSt", {
    method: "DELETE",
    headers: { "X-API-KEY": "your_api_key" },
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  { "deleted": true, "id": "AbCdEfGhIjKlMnOpQrSt" }
  ```

  ```json 404 Not Found theme={null}
  { "error": "Event not found" }
  ```
</ResponseExample>