---
title: "Delete metadata value"
method: DELETE
path: "/documents/{document}/metadata-values/{metadataValue}"
tags: ["Document Operations"]
---

# Delete metadata value

`DELETE /documents/{document}/metadata-values/{metadataValue}`

<small>Requires an API token with the **Document Manager** role.</small>

Removes the value of a [metadata](/#metadata) field from a [document](/#documents).

If the metadata `always_exists`, it will just be unattached from the document and reset to its default value. For
all other metadata, the value will be deleted.

> Alternatively: if your use case involves removing the values of multiple metadata fields at once, the [bulk
> update metadata values](/operations/v1.documents.metadata-values.bulk-update) request is likely to be a better
> fit.

## Path parameters

- `document` string, required
- `metadataValue` string, required

## Response `204`

No content

## Other responses

- `401` — Unauthenticated
- `403` — Authorization error
- `404` — Not found

---

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