# addAssetMetadataFieldValue

> Mutation in domain **Assets**

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

Add a new relation between an existing `Asset` and an existing `MetadataField` with its value. The value will be automatically created and linked to its `MetadataField`. Requires `basic:write` scope to be accessible and `Asset` permission level `EDIT`.

Status: _(deprecated)_

## Returns

`AddAssetMetadataFieldValue`

## Arguments

- `input`: `AddAssetMetadataFieldValueInput!` — `AddAssetMetadataFieldValue` input argument.

## Example

```graphql
mutation AddAssetMetadataFieldValue {
  addAssetMetadataFieldValue(
    input: {
      assetId: "…"
      metadataFieldId: "…"
      value: "…"
    }
  ) {
    __typename
    createdAt
    creator {
      __typename
      name
      id
    }
    id
    metadataField { __typename }
    modifiedAt
    modifier {
      __typename
      name
      id
    }
    value
  }
}
```

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