---
title: "Edit Email With Prompt"
method: POST
path: "/v1/emails/{emailId}/edit"
tags: ["Emails"]
---

# Edit Email With Prompt

`POST /v1/emails/{emailId}/edit`

Prompt Migma to edit one generated email. The same emailId remains valid; the response returns updated HTML and screenshot URLs. Requires API key with email:write permission.

## Path parameters

- `emailId` string, required

## Request body

- EditEmailRequest
  - `prompt` string, required — Natural-language edit request, e.g. "Make this shorter and more transactional".
  - `label` string — Optional version label.

## Response `200`

Email edited

- ApiResponseEmail
  - `success` boolean, required
  - `data` object, nullable
    - `id` string, required
    - `emailId` string, required
    - `conversationId` string, required
    - `messageId` string, nullable, required
    - `slotIdx` integer, required
    - `slotUuid` string, nullable, required
    - `status` string, required
    - `subject` string, required
    - `preheader` string, required
    - `html` string, required — Production-ready email HTML.
    - `screenshotUrl` string, uri, nullable
    - `thumbnailUrl` string, uri, nullable, required
    - `warnings` string[], required
    - `updatedAt` string, date-time, required
  - `error` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden - Missing required permissions or access denied
- `404` — Resource not found

---

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