---
title: "deletes existing guests that match new duplicate guests"
method: POST
path: "/4.0/guestlists/{guestlist_id}/guests/_replace"
tags: ["Guests"]
---

# deletes existing guests that match new duplicate guests

`POST /4.0/guestlists/{guestlist_id}/guests/_replace`

## Path parameters

- `guestlist_id` string, required

## Request body

- GuestsGuestListService
  - `id` string, required — id of guest
  - `first_name` string, required — first name of guest
  - `last_name` string, required — last name of guest
  - `email` string — email address
  - `checked_in_status` object — checkin data
    - `checked_in` integer
    - `checked_in_at` string, date-time
    - `checked_out_at` string, date-time
  - `tags` TagsGuestListService[]
    - `title` string, required — title of tag
    - `color` string — color of tag
  - `meals` MealsGuestListService[]
    - `title` string, required — name of meal

## Response `200`

returns guests

## Other responses

- `410` — guestlist is deleted

---

[API](https://skmtc.net/socialtables/apis/social-tables-api-gateway.md) · [All operations](https://skmtc.net/socialtables/apis/social-tables-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/socialtables/social-tables-api-gateway/versions/221c9d836cf0/schema)