> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Metafield Definition

> Delete a metafield definition. Values are NOT deleted. Admin API only.

# Delete Metafield Definition

<Warning>
  Admin API only — requires a merchant JWT. Not exposed to OAuth apps.
</Warning>

Deletes the schema. **Existing values that were written under this
definition are NOT removed** — they continue to exist as schema-less
metafields. Future writes to `(ownerType, namespace, key)` revert to the
relaxed (no-validation) path.

If you want to wipe values too, list them
([`GET /metafields?ownerType=...&namespace=...&key=...`](/api-reference/metafields/list))
and call
[`DELETE /metafields/:id`](/api-reference/metafields/delete) for each.

## Request

```bash theme={null}
curl -X DELETE "https://api.launchmystore.io/metafield-definitions/<id>" \
  -H "Authorization: Bearer <merchant-jwt>"
```

## Path parameters

<ParamField path="id" type="string" required>
  The definition UUID.
</ParamField>

## Response

```json theme={null}
{
  "status": 200,
  "state": "success",
  "message": "Metafield definition deleted"
}
```

## Error codes

| Code           | Description                     |
| -------------- | ------------------------------- |
| `UNAUTHORIZED` | Invalid or missing JWT          |
| `FORBIDDEN`    | Wrong store / insufficient role |
| `NOT_FOUND`    | Definition does not exist       |