---
title: "Merge Version"
method: POST
path: "/v1/projects/{project_id}/versions/{version_id}/merge"
tags: ["project-versions"]
---

# Merge Version

`POST /v1/projects/{project_id}/versions/{version_id}/merge`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/projects/{project_id}/versions/{version_id}/merge`
- Auth: none declared

Merge SOURCE (`{version_id}`) into TARGET (`into`, default = production).
UPSERTs translations with the chosen `strategy`; never deletes. `dry_run`
returns the report without writing (preview).

## Path parameters

- `version_id` string, required
- `project_id` string, required

## Request body

- MergeIn
  - `into` string, nullable: Target version uuid or slug to merge INTO. Defaults to the production version.
  - `strategy` string: source-wins (default) | target-wins (additive) | per-key (skip + report conflicts)
  - `namespaces` string[], nullable: Optional namespace-slug filter (default: all).
  - `languages` string[], nullable: Optional language-code filter (default: all).
  - `dry_run` boolean: Compute the report without writing — preview the merge.

## Response `200`

Successful Response

- MergeReport
  - `source` VersionRef, required
    - `uuid` string, required
    - `slug` string, required
  - `into` VersionRef, required
    - `uuid` string, required
    - `slug` string, required
  - `strategy` string, required
  - `dry_run` boolean, required
  - `added` integer, required
  - `updated` integer, required
  - `skipped` integer, required
  - `keys_created` integer, required
  - `conflicts` MergeConflict[], required
    - `namespace` string, nullable
    - `name` string, required
    - `language_code` string, required
    - `source_value` string, nullable
    - `target_value` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sonenta/apis/sonenta-api.md) · [All operations](https://skmtc.dev/sonenta/apis/sonenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonenta/apis/sonenta-api/revisions/f853ea49fb05?raw)