---
title: "Delete a batch of respondents from the study by using an array of respondent ids"
method: DELETE
path: "/Studies/{studyKey}/Respondents"
tags: ["StudyRespondents"]
---

# Delete a batch of respondents from the study by using an array of respondent ids

`DELETE /Studies/{studyKey}/Respondents`

Method deletes a batch of respondents by using an array of respondent ids

## Path parameters

- `studyKey` integer, required

## Request body

- DeleteStudyRespondentsRequest — Request model for deleting study respondents
  - `respondentIds` string[], nullable — List of respondent identifiers to be deleted

## Response `200`

OK

- DeleteStudyRespondentsResponse — Response of DeleteStudyRespondents API method
  - `errorMessage` string, nullable
  - `failedDeletions` DeleteStudyRespondentFailure[], nullable — List of Respondent Ids that failed to be deleted
    - `respondentID` string, nullable — ID of the respondent that failed to be deleted
    - `errorMessage` string, nullable — Error message describing why the deletion failed
  - `notFoundRespondentIds` string[], nullable — Array of respondents with no responses found

---

[API](https://skmtc.net/voxco/apis/acuity-webapi-1-0.md) · [All operations](https://skmtc.net/voxco/apis/acuity-webapi-1-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voxco/acuity-webapi-1-0/revisions/2ea4b8555197/schema)
