# Remove metadata record

Removes a metadata key with all its values from a resource.

[endpoint]
base_url = "https://incidents.betterstack.com"
path = "/api/v4/metadata/{metadata_id}"
method = "DELETE"

[[path_param]]
name = "metadata_id"
description = "The `id` of the metadata record, from [List metadata](https://betterstack.com/docs/uptime/api/list-all-existing-metadata/). It stands for all values of that key on that resource."
required = true
type = "string"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"
[/endpoint]

[responses]
[[response]]
status = 204
description = '''The key and its values were removed.'''
body = ''''''

[[response]]
status = 404
description = '''No metadata record with this ID exists in your team.'''
body = '''{
  "errors": "Resource type Metadata with id = 25 was not found"
}'''
[/responses]

#### Example cURL

```shell
[label Example]
curl --request DELETE \
  --url https://incidents.betterstack.com/api/v4/metadata/25 \
  --header "Authorization: Bearer $TOKEN"
```
