Metafield translations
Save a record's metafield translations
Token-authenticated. Saves translated values of one record’s metafields in one language. A value is created, or replaces the one already stored for that record, field and language. The record’s own metafield values, the originals, are never changed.
Every item is checked before anything is saved, and all are saved in one
transaction: a 422 means nothing was written. An item is refused when its
metafield definition is missing, is not marked translatable, or is not
of type single_line_text_field, multi_line_text_field,
rich_text_field, list.single_line_text_field or url, or when the
value is not valid for that type and the definition’s rules. The same
field twice in one request is refused. lang must be a language the
store sells in and not its default language.
source_digest is stored exactly as sent. Send the original_digest
the read endpoint issued for the original the translator saw.
A successful save schedules one purge of the company’s cached pages about five minutes later. Saves made before it runs share it.
Needs the permissions of the record’s resource: Product and Variant
the storefront (or legacy product) permissions, EnrollmentPack the
storefront (or legacy enrollment pack) permissions. A caller without
them gets 403 whether or not the record exists.
Answers 404 while the translatable-metafields feature is off for the
company, and for a record of another company (a variant counts as its
product’s).
PUT
/
api
/
v202604
/
company
/
metafield-translations
Save a record's metafield translations
curl --request PUT \
--url https://api.fluid.app/api/v202604/company/metafield-translations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"owner_type": "Product",
"owner_id": 48213,
"lang": "es",
"translations": [
{
"namespace": "custom",
"key": "how_to_use",
"value": "Mezcla una dosis con agua.",
"source_digest": "3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a"
},
{
"namespace": "custom",
"key": "benefits",
"value": [
"Energía",
"Resistencia"
],
"source_digest": "9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d"
}
]
}
'import requests
url = "https://api.fluid.app/api/v202604/company/metafield-translations"
payload = {
"owner_type": "Product",
"owner_id": 48213,
"lang": "es",
"translations": [
{
"namespace": "custom",
"key": "how_to_use",
"value": "Mezcla una dosis con agua.",
"source_digest": "3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a"
},
{
"namespace": "custom",
"key": "benefits",
"value": ["Energía", "Resistencia"],
"source_digest": "9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
owner_type: 'Product',
owner_id: 48213,
lang: 'es',
translations: [
{
namespace: 'custom',
key: 'how_to_use',
value: 'Mezcla una dosis con agua.',
source_digest: '3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a'
},
{
namespace: 'custom',
key: 'benefits',
value: ['Energía', 'Resistencia'],
source_digest: '9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d'
}
]
})
};
fetch('https://api.fluid.app/api/v202604/company/metafield-translations', 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.fluid.app/api/v202604/company/metafield-translations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'owner_type' => 'Product',
'owner_id' => 48213,
'lang' => 'es',
'translations' => [
[
'namespace' => 'custom',
'key' => 'how_to_use',
'value' => 'Mezcla una dosis con agua.',
'source_digest' => '3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a'
],
[
'namespace' => 'custom',
'key' => 'benefits',
'value' => [
'Energía',
'Resistencia'
],
'source_digest' => '9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d'
]
]
]),
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.fluid.app/api/v202604/company/metafield-translations"
payload := strings.NewReader("{\n \"owner_type\": \"Product\",\n \"owner_id\": 48213,\n \"lang\": \"es\",\n \"translations\": [\n {\n \"namespace\": \"custom\",\n \"key\": \"how_to_use\",\n \"value\": \"Mezcla una dosis con agua.\",\n \"source_digest\": \"3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a\"\n },\n {\n \"namespace\": \"custom\",\n \"key\": \"benefits\",\n \"value\": [\n \"Energía\",\n \"Resistencia\"\n ],\n \"source_digest\": \"9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.fluid.app/api/v202604/company/metafield-translations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"owner_type\": \"Product\",\n \"owner_id\": 48213,\n \"lang\": \"es\",\n \"translations\": [\n {\n \"namespace\": \"custom\",\n \"key\": \"how_to_use\",\n \"value\": \"Mezcla una dosis con agua.\",\n \"source_digest\": \"3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a\"\n },\n {\n \"namespace\": \"custom\",\n \"key\": \"benefits\",\n \"value\": [\n \"Energía\",\n \"Resistencia\"\n ],\n \"source_digest\": \"9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/company/metafield-translations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"owner_type\": \"Product\",\n \"owner_id\": 48213,\n \"lang\": \"es\",\n \"translations\": [\n {\n \"namespace\": \"custom\",\n \"key\": \"how_to_use\",\n \"value\": \"Mezcla una dosis con agua.\",\n \"source_digest\": \"3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a\"\n },\n {\n \"namespace\": \"custom\",\n \"key\": \"benefits\",\n \"value\": [\n \"Energía\",\n \"Resistencia\"\n ],\n \"source_digest\": \"9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"metafield_translations": {
"owner_type": "Product",
"owner_id": 48213,
"lang": "es",
"translations": [
{
"namespace": "custom",
"key": "how_to_use",
"value": "Mezcla una dosis con agua.",
"source_digest": "3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a"
}
]
},
"status": 200,
"meta": {
"request_uuid": "4c9fc097-1f78-43b8-b8e0-ef3bb7163381",
"timestamp": "2026-11-13T18:24:12Z"
}
}{
"message": "Invalid credentials."
}{
"error": "Not authorized."
}{
"error": {
"message": "Not found",
"details": {}
},
"status": 404,
"meta": {
"request_uuid": "4c9fc097-1f78-43b8-b8e0-ef3bb7163381",
"timestamp": "2026-11-13T18:24:12Z"
}
}{
"error": {
"message": "Invalid translations",
"details": {
"translations": {
"0": {
"field": [
"is not translatable"
]
}
}
}
},
"status": 422,
"meta": {
"request_uuid": "4c9fc097-1f78-43b8-b8e0-ef3bb7163381",
"timestamp": "2026-11-13T18:24:12Z"
}
}Authorizations
Bearer token authentication. Accepts company-admin tokens with
storefront.view for read operations and storefront.update
for writes and scan triggers (legacy per-resource grants like
categories.update / products.view / etc. are still accepted
during the migration), required on every company operation.
Storefront public operations under /api/v202604/{resource} and
/api/v202604/{resource}/{slug} are unauthenticated
(security: []).
Body
application/json
One record's translations in one language.
The values to save. Each one's definition must be translatable and of
type single_line_text_field, multi_line_text_field,
rich_text_field, list.single_line_text_field or url, and the
value must be valid for that type. Nothing is saved when any item
is refused.
Required array length:
1 - 100 elementsShow child attributes
Show child attributes
⌘I
Save a record's metafield translations
curl --request PUT \
--url https://api.fluid.app/api/v202604/company/metafield-translations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"owner_type": "Product",
"owner_id": 48213,
"lang": "es",
"translations": [
{
"namespace": "custom",
"key": "how_to_use",
"value": "Mezcla una dosis con agua.",
"source_digest": "3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a"
},
{
"namespace": "custom",
"key": "benefits",
"value": [
"Energía",
"Resistencia"
],
"source_digest": "9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d"
}
]
}
'import requests
url = "https://api.fluid.app/api/v202604/company/metafield-translations"
payload = {
"owner_type": "Product",
"owner_id": 48213,
"lang": "es",
"translations": [
{
"namespace": "custom",
"key": "how_to_use",
"value": "Mezcla una dosis con agua.",
"source_digest": "3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a"
},
{
"namespace": "custom",
"key": "benefits",
"value": ["Energía", "Resistencia"],
"source_digest": "9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
owner_type: 'Product',
owner_id: 48213,
lang: 'es',
translations: [
{
namespace: 'custom',
key: 'how_to_use',
value: 'Mezcla una dosis con agua.',
source_digest: '3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a'
},
{
namespace: 'custom',
key: 'benefits',
value: ['Energía', 'Resistencia'],
source_digest: '9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d'
}
]
})
};
fetch('https://api.fluid.app/api/v202604/company/metafield-translations', 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.fluid.app/api/v202604/company/metafield-translations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'owner_type' => 'Product',
'owner_id' => 48213,
'lang' => 'es',
'translations' => [
[
'namespace' => 'custom',
'key' => 'how_to_use',
'value' => 'Mezcla una dosis con agua.',
'source_digest' => '3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a'
],
[
'namespace' => 'custom',
'key' => 'benefits',
'value' => [
'Energía',
'Resistencia'
],
'source_digest' => '9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d'
]
]
]),
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.fluid.app/api/v202604/company/metafield-translations"
payload := strings.NewReader("{\n \"owner_type\": \"Product\",\n \"owner_id\": 48213,\n \"lang\": \"es\",\n \"translations\": [\n {\n \"namespace\": \"custom\",\n \"key\": \"how_to_use\",\n \"value\": \"Mezcla una dosis con agua.\",\n \"source_digest\": \"3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a\"\n },\n {\n \"namespace\": \"custom\",\n \"key\": \"benefits\",\n \"value\": [\n \"Energía\",\n \"Resistencia\"\n ],\n \"source_digest\": \"9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.fluid.app/api/v202604/company/metafield-translations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"owner_type\": \"Product\",\n \"owner_id\": 48213,\n \"lang\": \"es\",\n \"translations\": [\n {\n \"namespace\": \"custom\",\n \"key\": \"how_to_use\",\n \"value\": \"Mezcla una dosis con agua.\",\n \"source_digest\": \"3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a\"\n },\n {\n \"namespace\": \"custom\",\n \"key\": \"benefits\",\n \"value\": [\n \"Energía\",\n \"Resistencia\"\n ],\n \"source_digest\": \"9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/v202604/company/metafield-translations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"owner_type\": \"Product\",\n \"owner_id\": 48213,\n \"lang\": \"es\",\n \"translations\": [\n {\n \"namespace\": \"custom\",\n \"key\": \"how_to_use\",\n \"value\": \"Mezcla una dosis con agua.\",\n \"source_digest\": \"3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a\"\n },\n {\n \"namespace\": \"custom\",\n \"key\": \"benefits\",\n \"value\": [\n \"Energía\",\n \"Resistencia\"\n ],\n \"source_digest\": \"9d2c4e6f8a0b1c3d5e7f9a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"metafield_translations": {
"owner_type": "Product",
"owner_id": 48213,
"lang": "es",
"translations": [
{
"namespace": "custom",
"key": "how_to_use",
"value": "Mezcla una dosis con agua.",
"source_digest": "3b1f7c0e5a9d4e2b8c6a1f0d7e3b9a5c2d4f6e8a0b1c3d5e7f9a2b4c6d8e0f1a"
}
]
},
"status": 200,
"meta": {
"request_uuid": "4c9fc097-1f78-43b8-b8e0-ef3bb7163381",
"timestamp": "2026-11-13T18:24:12Z"
}
}{
"message": "Invalid credentials."
}{
"error": "Not authorized."
}{
"error": {
"message": "Not found",
"details": {}
},
"status": 404,
"meta": {
"request_uuid": "4c9fc097-1f78-43b8-b8e0-ef3bb7163381",
"timestamp": "2026-11-13T18:24:12Z"
}
}{
"error": {
"message": "Invalid translations",
"details": {
"translations": {
"0": {
"field": [
"is not translatable"
]
}
}
}
},
"status": 422,
"meta": {
"request_uuid": "4c9fc097-1f78-43b8-b8e0-ef3bb7163381",
"timestamp": "2026-11-13T18:24:12Z"
}
}