---
title: "Check whether a subscriber field can be permanently deleted."
method: GET
path: "/fields/{fieldId}/permanent-delete-check"
tags: ["Fields"]
---

# Check whether a subscriber field can be permanently deleted.

`GET /fields/{fieldId}/permanent-delete-check`

## Request

- Base URL: `https://api.maildroppa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maildroppa.com/fields/{fieldId}/permanent-delete-check`
- Auth: API key in header `X-API-Key`

Returns a fresh report for a future permanent-delete flow. This endpoint does not delete the field.

## Path parameters

- `fieldId` string, uuid, required

## Response `200`

Field permanent-delete check retrieved.

- FieldUsageReport: Fresh usage report for deciding whether a subscriber field can be archived or permanently deleted later.
  - `fieldId` string, uuid
  - `fieldLabel` string: Human-readable field label.
  - `personalizationTagName` string: Stable subscriber personalization tag name.
  - `fieldType` 'TEXT' | 'LONG_TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_CHOICE' | 'MULTI_CHOICE'
  - `subscriberValueCount` integer: Subscriber field value assignments for this field. Multi-option rows count once per subscriber and field.
  - `archiveBlocked` boolean: True when current write references block archival.
  - `permanentDeleteBlocked` boolean: True when current references or running sends block a future permanent delete check.
  - `blockingUsages` FieldUsage[]: Known write usages that block archival.
    - `category` 'FORM' | 'AUTOMATION' | 'SEGMENT' | 'PURCHASE_CONNECTION' | 'IMPORT' | 'SEND_FILTER' | 'CONTENT_MERGE_TAG' | 'SEND_IN_PROGRESS' | 'EXTERNAL_HINT'
    - `area` string: Customer-facing content or product area.
    - `artifactId` string, uuid
    - `artifactName` string: Owning artifact name when one exists.
    - `status` string: Owning artifact status when one exists.
    - `reason` string: Business reason why this reference blocks, warns, or informs.
    - `link` string: Stable link to the owning area when available.
    - `permanentDeleteBlocking` boolean: True when this usage blocks a future permanent delete check.
  - `warningUsages` FieldUsage[]: Known read or control usages that can continue after archival.
    - `category` 'FORM' | 'AUTOMATION' | 'SEGMENT' | 'PURCHASE_CONNECTION' | 'IMPORT' | 'SEND_FILTER' | 'CONTENT_MERGE_TAG' | 'SEND_IN_PROGRESS' | 'EXTERNAL_HINT'
    - `area` string: Customer-facing content or product area.
    - `artifactId` string, uuid
    - `artifactName` string: Owning artifact name when one exists.
    - `status` string: Owning artifact status when one exists.
    - `reason` string: Business reason why this reference blocks, warns, or informs.
    - `link` string: Stable link to the owning area when available.
    - `permanentDeleteBlocking` boolean: True when this usage blocks a future permanent delete check.
  - `contentMergeTagUsages` FieldUsage[]: Live merge-tag findings in sendable content. These do not block archival.
    - `category` 'FORM' | 'AUTOMATION' | 'SEGMENT' | 'PURCHASE_CONNECTION' | 'IMPORT' | 'SEND_FILTER' | 'CONTENT_MERGE_TAG' | 'SEND_IN_PROGRESS' | 'EXTERNAL_HINT'
    - `area` string: Customer-facing content or product area.
    - `artifactId` string, uuid
    - `artifactName` string: Owning artifact name when one exists.
    - `status` string: Owning artifact status when one exists.
    - `reason` string: Business reason why this reference blocks, warns, or informs.
    - `link` string: Stable link to the owning area when available.
    - `permanentDeleteBlocking` boolean: True when this usage blocks a future permanent delete check.
  - `permanentDeleteBlockingUsages` FieldUsage[]: Usages that currently block a future permanent delete check.
    - `category` 'FORM' | 'AUTOMATION' | 'SEGMENT' | 'PURCHASE_CONNECTION' | 'IMPORT' | 'SEND_FILTER' | 'CONTENT_MERGE_TAG' | 'SEND_IN_PROGRESS' | 'EXTERNAL_HINT'
    - `area` string: Customer-facing content or product area.
    - `artifactId` string, uuid
    - `artifactName` string: Owning artifact name when one exists.
    - `status` string: Owning artifact status when one exists.
    - `reason` string: Business reason why this reference blocks, warns, or informs.
    - `link` string: Stable link to the owning area when available.
    - `permanentDeleteBlocking` boolean: True when this usage blocks a future permanent delete check.
  - `externalHints` FieldUsage[]: External write-path notices that do not block archival.
    - `category` 'FORM' | 'AUTOMATION' | 'SEGMENT' | 'PURCHASE_CONNECTION' | 'IMPORT' | 'SEND_FILTER' | 'CONTENT_MERGE_TAG' | 'SEND_IN_PROGRESS' | 'EXTERNAL_HINT'
    - `area` string: Customer-facing content or product area.
    - `artifactId` string, uuid
    - `artifactName` string: Owning artifact name when one exists.
    - `status` string: Owning artifact status when one exists.
    - `reason` string: Business reason why this reference blocks, warns, or informs.
    - `link` string: Stable link to the owning area when available.
    - `permanentDeleteBlocking` boolean: True when this usage blocks a future permanent delete check.

## Other responses

- `401`: Not Authorized
- `403`: Not Allowed
- `404`: Field not found.
- `428`: Accept the customer agreements in the app before using API keys.

---

[API](https://skmtc.dev/maildroppa/apis/maildroppa-api-beta.md) · [All operations](https://skmtc.dev/maildroppa/apis/maildroppa-api-beta/llms.txt) · [OpenAPI document](https://skmtc.dev/maildroppa/apis/maildroppa-api-beta/revisions/a9f5a3fd1fb0?raw)