---
title: "Resend a batch's failed emails"
method: POST
path: "/v1/batches/{batch_id}/resend-emails"
tags: ["Batches"]
---

# Resend a batch's failed emails

`POST /v1/batches/{batch_id}/resend-emails`

## Request

- Base URL: `https://api-eu.dynamicdocumentapi.com`
- URL: `https://api-eu.dynamicdocumentapi.com/v1/batches/{batch_id}/resend-emails`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

For each item and rule, the newest email is resent when its status is listed (`failed` by default; `unknown` only when listed). Emails that can't be resent are listed in `skipped` with the reason (at most 100).

## Path parameters

- `batch_id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- BatchResendEmailsRequest: `POST /v1/batches/{id}/resend-emails`.
  - `statuses` string[]: Resend the newest email of each render and rule when its status is listed.

## Response `200`

- BatchResendEmailsResult
  - `resent` integer, required
  - `skipped` object[], required: Emails that could not be resent (at most 100 listed).
    - `code` 'email_not_resendable' | 'email_file_expired'
    - `send_id` string

## Other responses

- `400`: Unknown status.
- `401`: Missing, invalid, expired or revoked credentials.
- `402`: Email delivery needs the Growth plan or higher (`plan_feature_unavailable`).
- `403`: Insufficient scope, IP not allowed, workspace suspended or scheduled for deletion, or email not verified.
- `404`: Batch not found.
- `429`: Rate limited (`Retry-After`).

---

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