---
title: "Delete a guest"
method: DELETE
path: "/v1/guests/{_id}"
tags: ["Guests"]
---

# Delete a guest

`DELETE /v1/guests/{_id}`

## Request

- Base URL: `https://envelope.so/api`
- URL: `https://envelope.so/api/v1/guests/{_id}`
- Auth: API key in header `x-api-key`

Permanently removes a guest and their associated data.

## Path parameters

- `_id` string, required

## Query parameters

- `event` string, required

## Response `200`

Guest deleted successfully.

- Guest
  - `_id` string, required: Guest ID
  - `event` string, required: Event ID
  - `confirmedAt` string, date-time, nullable: Date and time when the guest was confirmed
  - `attendedAt` string, date-time, nullable: Date and time when the guest attended the event
  - `starred` boolean: Indicates if the guest is starred
  - `status` object, required: Guest status information including confirmation, attendance, consents and check-in details
    - `confirmation` integer, required: -1 = declined, 0 = default, 1 = confirmed, 2 = confirmed + 1 partner, 3 = confirmed + 2 partners
    - `attendance` integer, required: 0 = default, 1 = attended, 2 = attended + 1 partner, 3 = attended + 2 partners
    - `declineMessage` string, nullable: Message from the guest when they declined the invitation
    - `givenConsents` string[], required: Array of consents that the guest has given
    - `visitedZones` string[], required: Array of zone IDs that the guest has visited
    - `addMethod` 'batchImport' | 'singleAdd' | 'checkInAdd' | 'publicRegistration': Method used to add the guest to the event
    - `checkInMethod` 'qrScan' | 'manual', nullable: Method used to check in the guest
  - `properties` object, required: Guest properties including default required fields and any custom properties defined for the event
    - `firstName` string, required: First name of the guest
    - `lastName` string, required: Last name of the guest
    - `email` string, required: Email address of the guest
    - `lang` string, required: Language of the guest

## Other responses

- `401`: Invalid or missing API key.
- `404`: Requested resource not found.

---

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