Skip to main content
DELETE
Delete Metafield Definition

Delete Metafield Definition

Admin API only — requires a merchant JWT. Not exposed to OAuth apps.
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=...) and call DELETE /metafields/:id for each.

Request

Path parameters

id
string
required
The definition UUID.

Response

Error codes

CodeDescription
UNAUTHORIZEDInvalid or missing JWT
FORBIDDENWrong store / insufficient role
NOT_FOUNDDefinition does not exist