Sync Template Localizations

POST

api

templates

{templateId}

localizations

sync

Sync Template Localizations

curl --request POST \
  --url https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "locales": [
    {}
  ],
  "skipEdited": true
}
'

import requests

url = "https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync"

payload = {
    "locales": [{}],
    "skipEdited": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({locales: [{}], skipEdited: true})
};

fetch('https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'locales' => [
        [
                
        ]
    ],
    'skipEdited' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync"

	payload := strings.NewReader("{\n  \"locales\": [\n    {}\n  ],\n  \"skipEdited\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"locales\": [\n    {}\n  ],\n  \"skipEdited\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"locales\": [\n    {}\n  ],\n  \"skipEdited\": true\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "templateId": "email_abc123",
  "queuedLocales": ["es", "fr"],
  "queuedVariantCount": 2
}

{
  "error": "No supported non-primary locales are configured for this company."
}

{
  "error": "Template not found"
}

Queue AI translation for selected enabled locales. Send an empty object to sync every enabled non-primary locale. This explicit operation works even when the company’s automatic on-save localization mode is disabled. Translation runs in the background. Each queued locale shows syncing until the job writes synced (or failed with lastError); poll Get Template to follow it.

Request

string

required

Template ID, transactional email ID, or transactional slug.

array

Enabled non-primary locale codes to sync. Omit to sync every enabled non-primary locale.

boolean

default:"false"

Keep translations edited in the dashboard or stored with keepEdits (see editedAt on Set Template Localization) instead of retranslating them. Kept locales are returned in skippedLocales. When every requested locale is kept, the response is 200 with an empty queuedLocales. Without this field, edited translations are retranslated and lose their edits, as before.

curl -X POST "https://api.sequenzy.com/api/v1/templates/email_abc123/localizations/sync" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"locales":["es","fr"]}'

Response fields

string[]

Locales queued for AI translation.

number

Number of queued locales.

string[]

Requested locales kept because someone edited them. Only returned when skipEdited is true.

Responses

{
  "success": true,
  "templateId": "email_abc123",
  "queuedLocales": ["es", "fr"],
  "queuedVariantCount": 2
}

{
  "error": "No supported non-primary locales are configured for this company."
}

{
  "error": "Template not found"
}

Sync Template Localizations

curl --request POST \
  --url https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "locales": [
    {}
  ],
  "skipEdited": true
}
'

import requests

url = "https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync"

payload = {
    "locales": [{}],
    "skipEdited": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({locales: [{}], skipEdited: true})
};

fetch('https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'locales' => [
        [
                
        ]
    ],
    'skipEdited' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync"

	payload := strings.NewReader("{\n  \"locales\": [\n    {}\n  ],\n  \"skipEdited\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"locales\": [\n    {}\n  ],\n  \"skipEdited\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/templates/{templateId}/localizations/sync")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"locales\": [\n    {}\n  ],\n  \"skipEdited\": true\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "templateId": "email_abc123",
  "queuedLocales": ["es", "fr"],
  "queuedVariantCount": 2
}

{
  "error": "No supported non-primary locales are configured for this company."
}

{
  "error": "Template not found"
}

​Request

​Response fields

​Responses

Request

Response fields

Responses