---
title: "Update Digest"
method: PATCH
path: "/api/v1/internal/release-email/digests/{digest_id}"
tags: ["internal", "release-email"]
---

# Update Digest

`PATCH /api/v1/internal/release-email/digests/{digest_id}`

## Path parameters

- `digest_id` string, uuid, required

## Request body

- UpdateDigestRequest — A partial edit, where omitting a field and nulling it differ. Only the keys actually present in the request body are written, so sending ``preheader: null`` clears the preview line while leaving the key out keeps whatever is on file.
  - `subject` string, nullable
  - `preheader` string, nullable
  - `body_markdown` string, nullable

## Response `200`

Successful Response

- ReleaseEmailDigestResponse
  - `id` string, uuid, required
  - `month_start` string, date, required
  - `subject` string, required
  - `preheader` string, nullable, required
  - `body_markdown` string, required
  - `status` 'draft' | 'sending' | 'sent', required — Where a digest sits between editable and shipped. ``SENDING`` exists so the claim on a send can be taken *before* Resend is called: the broadcast is the irreversible step, and a status that only changed after it returned would let a double click or a retry mail every customer twice.
  - `last_test_sent_at` string, date-time, nullable, required
  - `updated_at` string, date-time, required
  - `sent_at` string, date-time, nullable, required
  - `recipient_count` integer, nullable, required
  - `resend_broadcast_id` string, nullable, required
  - `internal_test_broadcast_id` string, nullable, required
  - `internal_test_sent_at` string, date-time, nullable, required
  - `is_sent` boolean, required
  - `is_locked` boolean, required
  - `is_test_send_current` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.net/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia-analytics/maia-api/versions/c5094ff58a23/schema)