Skip to main content
DELETE
/
metafield-definitions
/
:id
Delete Metafield Definition
curl --request DELETE \
  --url https://api.launchmystore.io/metafield-definitions/:id \
  --header 'Authorization: Bearer <token>'

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

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

curl -X DELETE "https://api.launchmystore.io/metafield-definitions/<id>" \
  -H "Authorization: Bearer <merchant-jwt>"

​
Path parameters

​
id
string
required
The definition UUID.

​
Response

{
  "status": 200,
  "state": "success",
  "message": "Metafield definition deleted"
}

​
Error codes

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