Attribute and attribute option translations

Get attribute translation

GET read_products + read_translations

Fetch one attribute translation.

Returns stored translated attribute fields for one locale, including whether the translation is out of date. Attribute translations cover name, slug, and description; option labels/values use the Attribute Option translation endpoints.

Path parameters

Name	Type	Description
`id` required	`integer`	Attribute id. Example: `7`
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Errors

400 STORE_API_INVALID_ATTRIBUTE_ID
Attribute id must be an integer.
400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for attributes.
404 ATTRIBUTE_NOT_FOUND
Attribute does not exist in this store.

curl https://api-store.tringify.com/api/2025-01/attributes/7/translations/fr \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/attributes/7/translations/fr", {
  method: "GET",
  headers: { "Authorization": "Bearer YOUR_STORE_API_TOKEN" },
});
const data = await res.json();

import requests

res = requests.get(
    "https://api-store.tringify.com/api/2025-01/attributes/7/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "is_outdated": false,
    "locale": "fr",
    "resource_id": "7",
    "resource_type": "attribute",
    "translations": {
      "description": "Choix de couleur.",
      "name": "Couleur",
      "slug": "couleur"
    }
  },
  "success": true
}

Set attribute translation

PUT write_products + write_translations

Set one attribute translation.

Writes translated attribute fields for one locale. Empty values clear the matching field translation.

Path parameters

Name	Type	Description
`id` required	`integer`	Attribute id. Example: `7`
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Body parameters

Name	Type	Description
`translations` required	`object`	Field-keyed translation values. Allowed fields: name, slug, description. Example: `{"name": "Couleur", "slug": "couleur", "description": "Choix de couleur."}`

Errors

400 STORE_API_INVALID_ATTRIBUTE_ID
Attribute id must be an integer.
400 STORE_API_INVALID_REQUEST_BODY
Request body is not valid JSON or does not match the expected shape.
400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for attributes.
404 ATTRIBUTE_NOT_FOUND
Attribute does not exist in this store.

curl -X PUT https://api-store.tringify.com/api/2025-01/attributes/7/translations/fr \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "translations": {
    "description": "Choix de couleur.",
    "name": "Couleur",
    "slug": "couleur"
  }
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/attributes/7/translations/fr", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "translations": {
      "description": "Choix de couleur.",
      "name": "Couleur",
      "slug": "couleur"
    }
  }),
});
const data = await res.json();

import requests

res = requests.put(
    "https://api-store.tringify.com/api/2025-01/attributes/7/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "translations": {
            "description": "Choix de couleur.",
            "name": "Couleur",
            "slug": "couleur",
        },
    },
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "is_outdated": false,
    "locale": "fr",
    "resource_id": "7",
    "resource_type": "attribute",
    "translations": {
      "description": "Choix de couleur.",
      "name": "Couleur",
      "slug": "couleur"
    }
  },
  "success": true
}

Batch get attribute translations

GET read_products + read_translations

Fetch attribute translations in batch.

Returns translated attribute fields for multiple attribute ids in one locale.

Path parameters

Name	Type	Description
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Query parameters

Name	Type	Description
`ids` required	`string`	Comma-separated attribute ids. Example: `7,8,9`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Errors

400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for attributes.
404 ATTRIBUTE_NOT_FOUND
Attribute does not exist in this store.

curl https://api-store.tringify.com/api/2025-01/attributes/translations/fr?ids=7,8,9 \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/attributes/translations/fr?ids=7,8,9", {
  method: "GET",
  headers: { "Authorization": "Bearer YOUR_STORE_API_TOKEN" },
});
const data = await res.json();

import requests

res = requests.get(
    "https://api-store.tringify.com/api/2025-01/attributes/translations/fr?ids=7,8,9",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "translations": [
      {
        "fields": {
          "name": "Couleur"
        },
        "resource_id": "7",
        "resource_type": "attribute"
      }
    ]
  },
  "success": true
}

Batch set attribute translations

PUT write_products + write_translations

Set attribute translations in batch.

Writes translated attribute fields for multiple attribute ids in one locale. Either every row is written or, if any row is invalid, none are.

Path parameters

Name	Type	Description
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Body parameters

Name	Type	Description
`translations` required	`array<object>`	Rows with `id` and `fields`. Allowed fields: name, slug, description. Example: `[{"id": 7, "fields": {"name": "Couleur"}}]`

Errors

400 STORE_API_INVALID_REQUEST_BODY
Request body is not valid JSON or does not match the expected shape.
400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for attributes.
404 ATTRIBUTE_NOT_FOUND
Attribute does not exist in this store.

curl -X PUT https://api-store.tringify.com/api/2025-01/attributes/translations/fr \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "translations": [
    {
      "fields": {
        "name": "Couleur"
      },
      "id": 7
    }
  ]
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/attributes/translations/fr", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "translations": [
      {
        "fields": {
          "name": "Couleur"
        },
        "id": 7
      }
    ]
  }),
});
const data = await res.json();

import requests

res = requests.put(
    "https://api-store.tringify.com/api/2025-01/attributes/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "translations": [{
            "fields": {
                "name": "Couleur",
            },
            "id": 7,
        }],
    },
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "translations": [
      {
        "fields": {
          "name": "Couleur"
        },
        "resource_id": "7",
        "resource_type": "attribute"
      }
    ]
  },
  "success": true
}

Get attribute option translation

GET read_products + read_translations

Fetch one attribute option translation.

Returns stored translated option fields for one locale, including whether the translation is out of date. Attribute option translations cover label and value.

Path parameters

Name	Type	Description
`id` required	`integer`	Attribute option id. Example: `7`
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Errors

400 STORE_API_INVALID_ATTRIBUTE_ID
Attribute option id must be an integer.
400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for attribute options.
404 ATTRIBUTE_NOT_FOUND
Attribute option does not exist in this store.

curl https://api-store.tringify.com/api/2025-01/attribute-options/7/translations/fr \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/attribute-options/7/translations/fr", {
  method: "GET",
  headers: { "Authorization": "Bearer YOUR_STORE_API_TOKEN" },
});
const data = await res.json();

import requests

res = requests.get(
    "https://api-store.tringify.com/api/2025-01/attribute-options/7/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "is_outdated": false,
    "locale": "fr",
    "resource_id": "41",
    "resource_type": "attribute_option",
    "translations": {
      "label": "Rouge",
      "value": "rouge"
    }
  },
  "success": true
}

Set attribute option translation

PUT write_products + write_translations

Set one attribute option translation.

Writes translated option fields for one locale. Empty values clear the matching field translation.

Path parameters

Name	Type	Description
`id` required	`integer`	Attribute option id. Example: `7`
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Body parameters

Name	Type	Description
`translations` required	`object`	Field-keyed translation values. Allowed fields: label, value. Example: `{"label": "Rouge", "value": "rouge"}`

Errors

400 STORE_API_INVALID_ATTRIBUTE_ID
Attribute option id must be an integer.
400 STORE_API_INVALID_REQUEST_BODY
Request body is not valid JSON or does not match the expected shape.
400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for attribute options.
404 ATTRIBUTE_NOT_FOUND
Attribute option does not exist in this store.

curl -X PUT https://api-store.tringify.com/api/2025-01/attribute-options/7/translations/fr \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "translations": {
    "label": "Rouge",
    "value": "rouge"
  }
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/attribute-options/7/translations/fr", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "translations": {
      "label": "Rouge",
      "value": "rouge"
    }
  }),
});
const data = await res.json();

import requests

res = requests.put(
    "https://api-store.tringify.com/api/2025-01/attribute-options/7/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "translations": {
            "label": "Rouge",
            "value": "rouge",
        },
    },
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "is_outdated": false,
    "locale": "fr",
    "resource_id": "41",
    "resource_type": "attribute_option",
    "translations": {
      "label": "Rouge",
      "value": "rouge"
    }
  },
  "success": true
}

Batch get attribute option translations

GET read_products + read_translations

Fetch attribute option translations in batch.

Returns translated option fields for multiple option ids in one locale.

Path parameters

Name	Type	Description
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Query parameters

Name	Type	Description
`ids` required	`string`	Comma-separated attribute option ids. Example: `41,42,43`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Errors

400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for attribute options.
404 ATTRIBUTE_NOT_FOUND
Attribute option does not exist in this store.

curl https://api-store.tringify.com/api/2025-01/attribute-options/translations/fr?ids=41,42,43 \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/attribute-options/translations/fr?ids=41,42,43", {
  method: "GET",
  headers: { "Authorization": "Bearer YOUR_STORE_API_TOKEN" },
});
const data = await res.json();

import requests

res = requests.get(
    "https://api-store.tringify.com/api/2025-01/attribute-options/translations/fr?ids=41,42,43",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "translations": [
      {
        "fields": {
          "label": "Rouge"
        },
        "resource_id": "41",
        "resource_type": "attribute_option"
      }
    ]
  },
  "success": true
}

Batch set attribute option translations

PUT write_products + write_translations

Set attribute option translations in batch.

Writes translated option fields for multiple option ids in one locale. Either every row is written or, if any row is invalid, none are.

Path parameters

Name	Type	Description
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.

Body parameters

Name	Type	Description
`translations` required	`array<object>`	Rows with `id` and `fields`. Allowed fields: label, value. Example: `[{"id": 41, "fields": {"label": "Rouge", "value": "rouge"}}]`

Errors

400 STORE_API_INVALID_REQUEST_BODY
Request body is not valid JSON or does not match the expected shape.
400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for attribute options.
404 ATTRIBUTE_NOT_FOUND
Attribute option does not exist in this store.

curl -X PUT https://api-store.tringify.com/api/2025-01/attribute-options/translations/fr \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "translations": [
    {
      "fields": {
        "label": "Rouge",
        "value": "rouge"
      },
      "id": 41
    }
  ]
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/attribute-options/translations/fr", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "translations": [
      {
        "fields": {
          "label": "Rouge",
          "value": "rouge"
        },
        "id": 41
      }
    ]
  }),
});
const data = await res.json();

import requests

res = requests.put(
    "https://api-store.tringify.com/api/2025-01/attribute-options/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "translations": [{
            "fields": {
                "label": "Rouge",
                "value": "rouge",
            },
            "id": 41,
        }],
    },
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "translations": [
      {
        "fields": {
          "label": "Rouge"
        },
        "resource_id": "41",
        "resource_type": "attribute_option"
      }
    ]
  },
  "success": true
}