# addCustomMetadata

> Mutation in domain **Metadata**

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

Add `CustomMetadata` values to a supported parent (`Asset` | `WorkspaceProject`). Requires `basic:write` scope to be accessible and permission level `EDIT` for the respective parent.

## Returns

`AddCustomMetadata`

## Arguments

- `input`: `AddCustomMetadataInput!` — `AddCustomMetadata` input argument.

## Example

```graphql
mutation AddCustomMetadata {
  addCustomMetadata(
    input: {
      parentIds: ["…"]
      customMetadata: [
        {
          propertyId: "…"
        }
      ]
    }
  ) {
    __typename
    parentIds
  }
}
```

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