---
title: "Bulk delete candidates"
method: POST
path: "/v1/candidates/bulk/delete"
tags: ["Bulk Candidates"]
---

# Bulk delete candidates

`POST /v1/candidates/bulk/delete`

Bulk delete candidates by ID or email address

## Request body

- union
  - object
    - `ids` integer[], required — Array of candidate IDs to be deleted (mutually exclusive with emails)
    - `emails` string[] — Array of candidate email addresses to be deleted (mutually exclusive with ids)
  - object
    - `ids` integer[] — Array of candidate IDs to be deleted (mutually exclusive with emails)
    - `emails` string[], required — Array of candidate email addresses to be deleted (mutually exclusive with ids)

## Response `201`

successful - delete by emails

- object
  - `data` BackgroundTask, required
    - `id` integer, required
    - `account_id` integer, required
    - `project_id` integer, nullable
    - `user_id` integer, required
    - `status` 'pending' | 'processing' | 'finished' | 'failed' | 'cancelled' | 'failed_internal', required
    - `finished_at` string, date-time, nullable, required
    - `error_message` string, nullable, required
    - `action` 'bulk_delete' | 'bulk_edit_candidates' | 'bulk_create_candidates' | 'bulk_shortlist' | 'create_and_shortlist', required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400` — bad request - neither ids nor emails provided
- `401` — unauthorized

---

[API](https://skmtc.dev/greatquestion/apis/api-reference-v1.md) · [All operations](https://skmtc.dev/greatquestion/apis/api-reference-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greatquestion/api-reference-v1/revisions/f263ec4858a6/schema)