---
title: "Remove metadata instance from folder"
method: DELETE
path: "/folders/{folder_id}/metadata/{scope}/{template_key}"
tags: ["Metadata instances (Folders)"]
---

# Remove metadata instance from folder

`DELETE /folders/{folder_id}/metadata/{scope}/{template_key}`

Deletes a piece of folder metadata.

## Path parameters

- `folder_id` string, required
- `scope` 'global' | 'enterprise', required
- `template_key` string, required

## Response `204`

Returns an empty response when the metadata is
successfully deleted.

## Other responses

- `400` — Returned when the request parameters are not valid. This may happen of the `scope` is not valid.
- `404` — Returns an error when the folder does not have an instance of the metadata template applied to it, or when the user does not have access to the folder. * `instance_not_found` - An instance of the metadata template with the given `scope` and `templateKey` was not found on this folder. * `not_found` - The folder was not found, or the user does not have access to the folder.
- `405` — Returned when the method was not allowed. This often happens when the folder ID is not valid or the root folder with ID `0`.
- `default` — An unexpected client error.

---

[API](https://skmtc.dev/box/apis/platform-api.md) · [All operations](https://skmtc.dev/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)