# removeMetadataValue

> Mutation in domain **Metadata**

- HTML: [removeMetadataValue.html](removeMetadataValue.html)
- Raw SDL: [removeMetadataValue.sdl](removeMetadataValue.sdl)
- Covered by: [llms.txt](../llms.txt)

Remove existing `MetadataField` value.Existing relations to that `MetadataField` with the same value will be automatically removed.Requires `basic:write` scope to be accessible and `Asset` permission level `EDIT`.

Status: _(deprecated)_

## Returns

`RemoveMetadataValue`

## Arguments

- `input`: `RemoveMetadataValueInput!` — `RemoveMetadataValue` input argument.

## Example

```graphql
mutation RemoveMetadataValue {
  removeMetadataValue(
    input: {
      id: "…"
    }
  ) {
    __typename
    createdAt
    creator {
      __typename
      name
      id
    }
    id
    metadataField { __typename }
    modifiedAt
    modifier {
      __typename
      name
      id
    }
    value
  }
}
```

Raw: [`removeMetadataValue.example.sdl`](removeMetadataValue.example.sdl)