---
title: "Update email outbox entry"
method: PATCH
path: "/emails/outbox/{id}"
tags: ["Emails"]
---

# Update email outbox entry

`PATCH /emails/outbox/{id}`

Updates an email in the outbox. Can be used to edit email content, pause/resume, or cancel emails. Only emails in editable states (`paused`, `preparing`, `rendering`, `render-error`, `scheduled`, `queued`, `server-error`) can be modified.

## Path parameters

- `id` string

## Query parameters

- `status` string
- `simple_status` string

## Request body

- object
  - `tsx_source` string
  - `theme_id` 'null', nullable
  - `to` object
  - `variables` object
  - `skip_deliverability_check` boolean
  - `scheduled_at_millis` number
  - `is_paused` boolean
  - `cancel` boolean

## Response `200`

Successful response

- unknown

## Changes

- **2026-07-23** `ae5572197e85` — 1 breaking, 2 info
  - request property `theme_id` was restricted to a list of enum values
  - the request property `theme_id` became nullable
  - added the new `undefined` enum value to the request property `theme_id`

[Change history](https://skmtc.dev/hexclave/apis/hexclave-rest-api-3/changes/emails/outbox/:id/patch.md)

---

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