---
title: "Delete a survey"
url: https://docs.gleap.ai/en/reference/rest-api/delete-survey
method: DELETE
path: "/engagement/surveys/{surveyId}"
api: "API Reference"
tag: "Engagement Survey"
operationId: "DeleteSurvey"
updatedAt: "2026-11-01T18:40:15.677Z"
language: en
---

# Delete a survey

`DELETE https://api.gleap.io/v3/engagement/surveys/{surveyId}`

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.

## Authorization

- `Authorization` (header, required): `Bearer <token>`

## Path parameters

- `surveyId` (string, required)

## Headers

- `project` (string, required)

## Example request

```bash
curl --request DELETE \
  --url 'https://api.gleap.io/v3/engagement/surveys/{surveyId}' \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>'
```

## Responses

### 200 (`application/json`)

Ok