← All API sections

Dead Letters

View, retry, or delete failed emails from the dead letter queue

3 endpoints

Endpoints

Method	Path	Description
GET	`/v1/dead-letters`	GET /v1/dead-letters
DELETE	`/v1/dead-letters/{id}`	DELETE /v1/dead-letters/{id}
POST	`/v1/dead-letters/{id}/retry`	POST /v1/dead-letters/{id}/retry

GET `/v1/dead-letters`

GET /v1/dead-letters

Parameters

Name	In	Type	Required	Description
`count`	query	`integer`	No	Number of items to return (default: 50, max: 200)

Responses

Status	Description
200	List of dead letter messages
401	Unauthorized

Example

curl -X GET https://api.euromail.dev/v1/dead-letters \
  -H "X-EuroMail-Api-Key: em_live_..."

import { EuroMail } from "@euromail/sdk";

const euromail = new EuroMail({ apiKey: "em_live_..." });

const result = await euromail.listDeadLetters();

from euromail import EuroMail

client = EuroMail(api_key="em_live_...")

result = client.list_dead_letters()

use euromail::EuroMail;

let client = EuroMail::new("em_live_...");

let result = client.list_dead_letters().await?;

client := euromail.NewClient("em_live_...")

result, err := client.ListDeadLetters(ctx)

DELETE `/v1/dead-letters/{id}`

DELETE /v1/dead-letters/{id}

Parameters

Name	In	Type	Required	Description
`id`	path	`string`	Yes	Stream ID of the dead letter

Responses

Status	Description
204	Dead letter deleted
401	Unauthorized

Example

curl -X DELETE https://api.euromail.dev/v1/dead-letters/{id} \
  -H "X-EuroMail-Api-Key: em_live_..."

import { EuroMail } from "@euromail/sdk";

const euromail = new EuroMail({ apiKey: "em_live_..." });

const result = await euromail.deleteDeadLetter("id_...");

from euromail import EuroMail

client = EuroMail(api_key="em_live_...")

result = client.delete_dead_letter("id_...")

use euromail::EuroMail;

let client = EuroMail::new("em_live_...");

let result = client.delete_dead_letter("id_...").await?;

client := euromail.NewClient("em_live_...")

result, err := client.DeleteDeadLetter(ctx, "id_...")

POST `/v1/dead-letters/{id}/retry`

POST /v1/dead-letters/{id}/retry

Parameters

Name	In	Type	Required	Description
`id`	path	`string`	Yes	Stream ID of the dead letter

Responses

Status	Description
200	Dead letter re-enqueued for retry
401	Unauthorized

Example

curl -X POST https://api.euromail.dev/v1/dead-letters/{id}/retry \
  -H "X-EuroMail-Api-Key: em_live_..."

import { EuroMail } from "@euromail/sdk";

const euromail = new EuroMail({ apiKey: "em_live_..." });

const result = await euromail.getDeadLetterDetail("id_...");

from euromail import EuroMail

client = EuroMail(api_key="em_live_...")

result = client.get_dead_letter_detail("id_...")

use euromail::EuroMail;

let client = EuroMail::new("em_live_...");

let result = client.get_dead_letter_detail("id_...").await?;

client := euromail.NewClient("em_live_...")

result, err := client.GetDeadLetterDetail(ctx, "id_...")