HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In
GitHubNuGetDev CommunityDoc feedback

Language Branches

Describes the language branch endpoints of the Optimizely Content Definitions API.

📘

The Language Branch API is available only in version 3.4.0 or later of the Optimizely Content Definitions API.

Language branches are definitions of language and regions that should be available for creating content in.

Example Langauge Branch definition

{
  "name"        : "en-NZ",
  "displayName" : "English (New Zealand)",
  "urlSegment"  : "en_nz",
  "sortOrder"   : 50,
  "enabled"     : true
}

List Language Branches

List all language branch definitions in the system.

GET/api/episerver/v3.0/languagebranches

Get Language Branch

Retrieve a language branch definition by its name, such as de or en-UK.

GET/api/episerver/v3.0/languagebranches/{name}

Create Language Branch

Creates a new language branch definition.

POST/api/episerver/v3.0/languagebranches

Update or Create Language Branch

Updates the language branch definition with the provided name. If no language branch with the provided name exist, one is created. Any properties not provided in the payload will be cleared.

PUT/api/episerver/v3.0/languagebranches/{name}

Patch Language Branch

Patches an existing language branch definition with the provided name. Only include the properties that you want to update in the payload.

PATCH/api/episerver/v3.0/languagebranches/{name}

Enable Language Branch Example

Call PATCH /api/episerver/v3.0/languagebranches/en-nz with the following payload.

{
  "enabled" : true
}

Delete Language Branch

Deletes the language branch definition with the provided name. You can delete only unused language branch definitions.

DELETE/api/episerver/v3.0/languagebranches/{name}