Delete Metadata Schema

Deletes permanently the metadata schema.

In standard metadata schemas, this endpoint removes permanently all definitions. The standard metadata schemas are:

• Campaign
• Voucher
• Publication
• Redemption
• Product
• Customer
• Order
• Order line item
• Loyalty Tier
• Promotion Tier
• Earning rule
• Reward

If you want to delete only one definition, use the Update Metadata Schema endpoint. In the request, provide the "deleted": true pair in the definition object. This definition will be moved to Removed definitions.

If you want to create a new standard metadata schema, use the Create Metadata Schema endpoint.

🚧 Metadata Purging

This endpoint deletes permanently the metadata schemas only. However, it does not purge the metadata from associated entities, so the metadata added to those entities will remain.

If you want to purge metadata from the entities:

1. Remove all the definitions you want to purge. You can do this either in Voucherify Project Settings > Metadata Schema tab or with the Update Metadata Schema endpoint.
2. In Voucherify Project Settings > Metadata Schema tab, go to the relevant metadata schema.
3. In Removed definitions, click the bin button next to the definitions whose metadata you want to purge from entities. Note:

• This is an asynchronous action. You will be notified when it has been completed.
• You cannot purge metadata for the Redemption and Publication schemas.

4. Use the Delete Metadata Schema request to delete the metadata schema from Voucherify.

📘 Metadata Documentation

Read the Getting Started with Metadata and Metadata Mapping articles to learn how metadata work in Voucherify.

Authorizations

X-Management-Id · string · header · required

X-Management-Token · string · header · required

Path Parameters

projectId · string · required

Provide the unique identifier of the project.

Example:

"proj_TrlkLiH4"

metadataSchemaId · string · required

Provide the unique identifier of the metadata schema.

Example:

"ms_f0r4hm3ta6a4a5ch3ma"

Response

204

Returns no content if the metadata schema has been successfully deleted.