---
title: "Link the source and target content as translations of each other"
method: POST
path: "/translation/link"
tags: ["Content Translation Operations"]
---

# Link the source and target content as translations of each other

`POST /translation/link`

Links the given source and target content as translations of each other.
This operations runs asynchronously. For the given source and target content:
* Source and target content must be in the same translation group
* Source and target content paths must be under the folder '/content/documents'
* Source and target content must have the same content type
* The layout and the components of the source content must exist in target content's channel (for pages)
* Source and target content must not have any existing translations in each other's channel (content can have maximum 1 translation in a channel)

The operation will fail if the source or target content already has a translation in each other's channel. The existing translations can be overridden via parameter.

## Query parameters

- `overrideExistingTranslations` boolean

## Request body

- object[] — The source and target content to link as translations
  - `path` string — path of the content
  - `translations` string[] — paths of the target translations

## Response `200`

OK

- TranslationJob — Translation job operation details
  - `operationId` string — generated unique id for the operation
  - `status` 'COMPLETED' | 'STARTING' | 'STARTED' | 'STOPPING' | 'STOPPED' | 'FAILED' | 'ABANDONED' — status of the operation
  - `exitMessage` string — exit message in case of operation failure
  - `readCount` integer — number of records in input payload
  - `writeCount` integer — written items
  - `skipCount` integer — skipped items
  - `startTime` string, date-time — operation start time
  - `endTime` string, date-time — operation end time
  - `errorLog` string[] — error logs for failed linking operations

---

[API](https://skmtc.net/bloomreach/apis/documents-delivery-api-2-0.md) · [All operations](https://skmtc.net/bloomreach/apis/documents-delivery-api-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bloomreach/documents-delivery-api-2-0/revisions/87bfc06578c2/schema)