---
title: "Undo an email to a candidate"
method: POST
path: "/candidates/email/cancel"
tags: ["candidate"]
---

# Undo an email to a candidate

`POST /candidates/email/cancel`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/candidates/email/cancel`
- Auth: HTTP bearer

Stops emails that haven't gone yet, within ten minutes of sending them. One that already went can't be called back.

## Request body

- object
  - `email_ids` string[], required

## Response `200`

The result.

- object
  - `cancelled` string[], required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)
