# addAssetRelations

> Mutation in domain **Assets**

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

Relate existing `Asset`s. The `relatedAssetIds` input field list is limited to 100 ids per request and cannot contain the same `assetId` input field value. Requires `basic:write` scope to be accessible and `Asset` permission level `EDIT`.

## Returns

`AddAssetRelations`

## Arguments

- `input`: `AddAssetRelationsInput!` — `AddAssetRelations` input argument.

## Example

```graphql
mutation AddAssetRelations {
  addAssetRelations(
    input: {
      assetId: "…"
      relatedAssetIds: ["…"]
    }
  ) {
    __typename
    asset {
      __typename
      title
      id
      alternativeText
      author
      createdAt
      description
      attachments {
        name
        filename
        id
        createdAt
        creator { id }
        modifier { id }
      }
      availability {
        from
        to
      }
      comments {
        total
        page
        limit
        hasNextPage
        items { id }
      }
      copyright {
        notice
        status
      }
      creator {
        __typename
        name
        id
      }
      ... on Audio {
        previewUrl
        thumbnailUrl
        filename
        downloadUrl
      }
      ... on Document {
        previewUrl
        thumbnailUrl
        filename
        downloadUrl
      }
      ... on EmbeddedContent {
        previewUrl
        thumbnailUrl
        isDecorative
      }
      ... on File {
        previewUrl
        thumbnailUrl
        filename
        downloadUrl
      }
      ... on Image {
        previewUrl
        thumbnailUrl
        filename
        downloadUrl
      }
      ... on Video {
        previewUrl
        thumbnailUrl
        filename
        bitrate
      }
    }
    relatedAssets {
      __typename
      title
      id
      alternativeText
      author
      createdAt
      description
      attachments {
        name
        filename
        id
        createdAt
        creator { id }
        modifier { id }
      }
      availability {
        from
        to
      }
      comments {
        total
        page
        limit
        hasNextPage
        items { id }
      }
      copyright {
        notice
        status
      }
      creator {
        __typename
        name
        id
      }
      ... on Audio {
        previewUrl
        thumbnailUrl
        filename
        downloadUrl
      }
      ... on Document {
        previewUrl
        thumbnailUrl
        filename
        downloadUrl
      }
      ... on EmbeddedContent {
        previewUrl
        thumbnailUrl
        isDecorative
      }
      ... on File {
        previewUrl
        thumbnailUrl
        filename
        downloadUrl
      }
      ... on Image {
        previewUrl
        thumbnailUrl
        filename
        downloadUrl
      }
      ... on Video {
        previewUrl
        thumbnailUrl
        filename
        bitrate
      }
    }
  }
}
```

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