Translate Missing Emails

POST

api

templates

localizations

translate-missing

Translate Missing Emails

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

import requests

url = "https://api.sequenzy.com/api/v1/templates/localizations/translate-missing"

payload = { "locales": [{}] }
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: [{}]})
};

fetch('https://api.sequenzy.com/api/v1/templates/localizations/translate-missing', 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/localizations/translate-missing",
  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' => [
        [
                
        ]
    ]
  ]),
  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/localizations/translate-missing"

	payload := strings.NewReader("{\n  \"locales\": [\n    {}\n  ]\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/localizations/translate-missing")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"locales\": [\n    {}\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/templates/localizations/translate-missing")

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}"

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

{
  "success": true,
  "locales": ["fr"],
  "queuedEmails": 14,
  "queuedTranslations": 14
}

{
  "error": "Locale \"de\" is not enabled for this company."
}

{
  "error": "Unauthorized"
}

{
  "error": "Company not found"
}

{
  "error": "Could not start the translations. Try again."
}

Queue AI translation for every sequence email (including sequence A/B variants) and enabled transactional email that has no translation in a language yet, or whose last translation failed. Send an empty object to cover every enabled non-primary locale. Adding a language in the dashboard already does this for that language. Use this endpoint to fill in emails added since, or to retry failed translations. Translations you edited, up-to-date translations and outdated ones are left alone. To retranslate one email, use Sync Template Localizations. Translations run in the background, behind translations someone is waiting for in the editor. Follow them with Get Translation Coverage. Repeating the request while translations are queued queues nothing new for them. Personal API keys with the marketer role only translate sequence emails.

Request

array

Enabled non-primary locale codes to translate into. Omit to translate into all of them. An empty array is rejected.

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

Response fields

string[]

Locales checked for missing translations.

number

Emails with at least one translation queued. 0 when nothing is missing.

number

Email and locale pairs queued.

Responses

{
  "success": true,
  "locales": ["fr"],
  "queuedEmails": 14,
  "queuedTranslations": 14
}

{
  "error": "Locale \"de\" is not enabled for this company."
}

{
  "error": "Unauthorized"
}

{
  "error": "Company not found"
}

{
  "error": "Could not start the translations. Try again."
}

Translate Missing Emails

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

import requests

url = "https://api.sequenzy.com/api/v1/templates/localizations/translate-missing"

payload = { "locales": [{}] }
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: [{}]})
};

fetch('https://api.sequenzy.com/api/v1/templates/localizations/translate-missing', 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/localizations/translate-missing",
  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' => [
        [
                
        ]
    ]
  ]),
  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/localizations/translate-missing"

	payload := strings.NewReader("{\n  \"locales\": [\n    {}\n  ]\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/localizations/translate-missing")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"locales\": [\n    {}\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/templates/localizations/translate-missing")

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}"

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

{
  "success": true,
  "locales": ["fr"],
  "queuedEmails": 14,
  "queuedTranslations": 14
}

{
  "error": "Locale \"de\" is not enabled for this company."
}

{
  "error": "Unauthorized"
}

{
  "error": "Company not found"
}

{
  "error": "Could not start the translations. Try again."
}

​Request

​Response fields

​Responses

Request

Response fields

Responses