---
title: "Delete a survey"
method: DELETE
path: "/engagement/surveys/{surveyId}"
tags: ["Engagement Survey"]
---

# Delete a survey

`DELETE /engagement/surveys/{surveyId}`

## Request

- Base URL: `https://api.gleap.io/v3`
- URL: `https://api.gleap.io/v3/engagement/surveys/{surveyId}`
- Auth: HTTP bearer

Permanently delete an engagement survey with everything stored for it: its versions, all of its
responses (with the files respondents uploaded, and the SURVEY tickets of a survey from before
Surveys 2.0), its stats and analytics, its delivery records and its search index entries. The
survey is gone at once; its data is deleted in the background within minutes. Live email
campaigns that send it are paused (their pending sends dropped) and kept without the link; see
`GET /{surveyId}/delete-preview`. This cannot be undone.

## Path parameters

- `surveyId` string, required

## Headers

- `project` string, required

## Response `200`

Ok

- unknown

---

[API](https://skmtc.dev/gleap/apis/gleap-server.md) - [All operations](https://skmtc.dev/gleap/apis/gleap-server/llms.txt) - [OpenAPI document](https://skmtc.dev/gleap/apis/gleap-server/revisions/3b025e883cef?raw)