Skip to main content
POST
/
v2
/
deleteRespondents
Delete respondents
curl --request POST \
  --url https://api.redem.io/v2/deleteRespondents \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
  "surveyName": "Customer-Satisfaction-2025",
  "respondentIds": [
    "R123",
    "R124"
  ]
}'
{
  "success": true,
  "message": "Respondents deleted successfully",
  "results": {
    "deleted": {
      "respondent": 2,
      "respondentMetadata": 2,
      "respondentInteractionData": 2,
      "flattenRespondents": 2,
      "survey": false
    }
  }
}
Delete one or more respondents from a survey. Also removes related metadata, interaction data, and flattened records. If no respondents remain for the survey, the survey is deleted automatically.

Authorizations

​
api-key
string
header
required

Body

application/json
​
surveyName
string
required

The survey name.

​
respondentIds
string[]
required

Array of respondent IDs to delete.

Minimum length: 1

Response

Successful deletion response.

​
success
boolean
​
message
string
​
results
object
⌘I