v1

latestOpenAPI 3.0.0Proprietary2026-07-26316155742.7 KB

Branches

Sync a branch

Pull changes from the base branch into this branch, applying the chosen conflict-resolution strategy.

The sync runs asynchronously. The branch transitions to syncing_branch and settles back into success (or merge_conflict / branch_error) once the background job completes; the response body for this request is empty. Poll the branch resource to observe the final state.

Only branches created with the newer branching system can be synced. Requests against branches from the older system, or against branches whose current state does not allow a sync, are rejected with 422 Unprocessable Entity and an empty body.

Requires the Branching feature to be enabled on the account.

patch/projects/{project_id}/branches/{name}/sync

Path parameters

project_idstring required

Project ID

namestring required

name

Headers

X-PhraseApp-OTPstring

Two-Factor-Authentication token (optional)

Request body

strategy'use_main' | 'use_branch'

Conflict resolution strategy applied when the branch and its base have diverged. use_main keeps the values from the base branch; use_branch keeps the values from this branch.

Example request

{
  "strategy": "use_main"
}

Response

OK. The sync has been scheduled. The response body is empty; observe progress by polling the branch resource.