Delete an email design

Hard-deletes every version of the design. Idempotent — a miss resolves with deleted: false plus a reason instead of a 404: already_deleted (this id was hard-deleted earlier; deletedAt carries when) or not_found (no such design on this brand, including cross-brand ids). An already_deleted response means the design is gone — do not retry.

DELETE /v1/emails/{emailId}

Delete an email design

cURL

curl --request DELETE \
  --url https://brew.new/api/v1/emails/{emailId} \
  --header 'Authorization: Bearer <token>'

200

{
  "emailId": "eml_welcome",
  "deleted": true
}

Authorizations

bearerAuthapiKeyAuth

Authorization · string · header · default: Bearer brew_your_api_key · required

Send your Brew API key as Authorization: Bearer brew_xxx.

Headers

X-Brand-Id · string

The brand this request acts on. REQUIRED for organization-scoped credentials (otherwise 400 BRAND_ID_REQUIRED — there is no default brand); list ids with GET /v1/brands. Brand-scoped credentials may omit it, and sending a different brand returns 403 BRAND_SCOPE_MISMATCH. A brand outside your organization returns 404 BRAND_NOT_FOUND.

Required string length: 1 - 64

Path Parameters

emailId · string · required

Design id returned by POST /v1/emails and listed by GET /v1/emails.

Required string length: 1 - 64

Example:

"eml_2SmZOWV3ZQ7W5x6g3m4p"

Response

200

application/json

Deleted (or already gone — see reason).

emailId · string · required

Minimum string length: 1

deleted · boolean · required

reason · enum<string>

Present when deleted is false: already_deleted means this design was hard-deleted earlier (see deletedAt) — it is gone, do not retry; not_found means no design with this id exists on this brand.

Available options: already_deleted, not_found

deletedAt · string

ISO timestamp of the earlier hard-delete (present with reason: "already_deleted").