---
title: "Get Email Edit Status"
method: GET
path: "/v1/emails/{emailId}/edits/{editId}"
tags: ["Emails"]
---

# Get Email Edit Status

`GET /v1/emails/{emailId}/edits/{editId}`

Get the exact queued edit status. Requires email:read and ownership of the email. A completed response includes the current saved Email in result. A failed response includes error and changesMayHaveBeenSaved; inspect the stored email before starting another edit. Failed or stalled jobs are not automatically rewritten. Do not infer this edit's status from conversation generation status.

## Path parameters

- `emailId` string, required
- `editId` string, required

## Response `200`

Current email edit operation

- ApiResponseEmailEditOperation
  - `success` boolean, required
  - `data` object, nullable
    - `editId` string, required
    - `emailId` string, required
    - `conversationId` string, required
    - `status` 'pending' | 'processing' | 'completed' | 'failed', required
    - `stage` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `pollAfterMs` integer, required
    - `error` string — Present when status is failed.
    - `changesMayHaveBeenSaved` boolean — Present when status is failed. Inspect the stored email before starting another edit.
    - `result` Email
      - `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` — Edit job is missing, expired, or does not belong to this email or owner.
- `503` — The edit queue is unavailable.

## Changes

- **2026-09-30** `6aa61fe25f1f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/migma/apis/migma-ai-api-v1/changes/v1/emails/:emailId/edits/:editId/get.md)

---

[API](https://skmtc.dev/migma/apis/migma-ai-api-v1.md) · [All operations](https://skmtc.dev/migma/apis/migma-ai-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/migma/apis/migma-ai-api-v1/revisions/9697a55a9fec?raw)