Tag translations

Get tag translation

GET read_products + read_translations

Fetch one tag translation.

Returns the stored name translation for one tag in the selected locale, with is_outdated. Tag slugs are not translatable: tags have no pages and filters match the source slug. Fields without a translation in this locale are omitted from the response. An omitted field is not empty: shoppers see the store's base-language value, which the resource's own GET endpoint returns.

Path parameters

Name	Type	Description
`id` required	`integer`	Tag 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_TAG_ID
Tag ID is invalid.
400 TRANSLATION_LOCALE_NOT_ENABLED
Locale is not enabled for this store.
400 TRANSLATION_DEFAULT_LOCALE_FORBIDDEN
Translations cannot target the store's default locale.
400 TRANSLATION_RESOURCE_ID_NOT_IN_STORE
Tag does not exist in this store.

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

const res = await fetch("https://api-store.tringify.com/api/2025-01/tags/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/tags/7/translations/fr",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "success": true,
  "data": {
    "fields": {
      "name": {
        "value": "Soldes d’été",
        "is_outdated": false,
        "word_count": 2
      }
    }
  }
}

Set tag translation

PUT write_products + write_translations

Set one tag translation.

Only name is translatable; a tag's slug stays the same in every language. Set name to an empty string to remove its translation.

Path parameters

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

Headers

Name	Type	Description
`Authorization` required	`string`	Bearer Store API token.
`Idempotency-Key`	`string`	Optional key for this translation write. Reuse it only with the same payload when repeating the request.

Body parameters

Name	Type	Description
`translations` required	`object`	Field-keyed translation values. The only allowed field is `name`. Example: `{"name": "Soldes d’été"}`

Errors

400 STORE_API_INVALID_TAG_ID
Tag ID is invalid.
400 STORE_API_INVALID_REQUEST_BODY
Request body must be a JSON object containing only documented fields; error.details.field identifies an unknown field.
400 TRANSLATION_LOCALE_NOT_ENABLED
Locale is not enabled for this store.
400 TRANSLATION_DEFAULT_LOCALE_FORBIDDEN
Translations cannot target the store's default locale.
400 TRANSLATION_FIELDS_REQUIRED
Each tag row must contain a translated name.
400 TRANSLATION_FIELD_NOT_TRANSLATABLE
A field is not translatable for tags; only name is, so sending slug returns this error.
400 TRANSLATION_TOO_MANY_FIELDS
The request exceeds the translation field limit.
400 TRANSLATION_STAGING_INVALID_CONTROL_CHARS
A translated value contains unsupported control characters.
400 TRANSLATION_FIELD_VALUE_TOO_LONG
A translated value exceeds the overall translation value limit.
400 TRANSLATION_FIELD_EXCEEDS_BYTE_LIMIT
A translated value exceeds the field's length limit.
400 TRANSLATION_RESOURCE_ID_NOT_IN_STORE
Tag does not exist in this store.
409 TAG_DUPLICATE
Translated name conflicts with another tag in this locale.
409 TRANSLATION_DUPLICATE_NAME_OR_SLUG
Translated name conflicted with another tag during the write.

curl -X PUT 'https://api-store.tringify.com/api/2025-01/tags/7/translations/fr' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "translations": {
    "name": "Soldes d’été"
  }
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/tags/7/translations/fr", {
  method: "PUT",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN","Content-Type":"application/json"},
  body: JSON.stringify({
    "translations": {
      "name": "Soldes d’été"
    }
  }),
});
const data = await res.json();

import requests

res = requests.put(
    "https://api-store.tringify.com/api/2025-01/tags/7/translations/fr",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
    json={
        "translations": {
            "name": "Soldes d’été",
        },
    },
)
data = res.json()

Response

200

Sample response

{
  "success": true,
  "code": "TRANSLATION_SAVED",
  "message": "Translation saved."
}

Batch get tag translations

GET read_products + read_translations

Fetch tag translations in batch.

Returns a resources entry keyed by tag:{id} for each requested tag. A tag without stored translations has an empty object. Fields without a translation in this locale are omitted from the response. An omitted field is not empty: shoppers see the store's base-language value, which the resource's own GET endpoint returns.

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 tag IDs. Example: `7,11`

Headers

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

Errors

400 TRANSLATION_LOCALE_NOT_ENABLED
Locale is not enabled for this store.
400 TRANSLATION_DEFAULT_LOCALE_FORBIDDEN
Translations cannot target the store's default locale.
400 TRANSLATION_RESOURCE_ID_REQUIRED
At least one tag ID is required.
400 TRANSLATION_INVALID_RESOURCE_ID
A tag ID is invalid.
400 TRANSLATION_RESOURCE_ID_NOT_IN_STORE
A tag does not exist in this store.
400 TRANSLATION_TOO_MANY_RESOURCES
The request exceeds the translation batch resource limit.

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

const res = await fetch("https://api-store.tringify.com/api/2025-01/tags/translations/fr?ids=7,11", {
  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/tags/translations/fr?ids=7,11",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "success": true,
  "data": {
    "resources": {
      "tag:7": {
        "name": {
          "value": "Soldes d’été",
          "is_outdated": false,
          "word_count": 2
        }
      },
      "tag:11": {}
    }
  }
}

Batch set tag translations

PUT write_products + write_translations

Set tag translations in batch.

Writes translations for multiple tags in one locale. The whole request succeeds or fails together; if any row is invalid, none are saved.

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.
`Idempotency-Key`	`string`	Optional key for this translation write. Reuse it only with the same payload when repeating the request.

Body parameters

Name	Type	Description
`translations` required	`array<object>`	Rows with `id` and `fields`. The only allowed field key is `name`. Example: `[{"id": 7, "fields": {"name": "Soldes d’été"}}]`

Errors

400 STORE_API_INVALID_REQUEST_BODY
Request body must be a JSON object containing only documented fields; error.details.field identifies an unknown field.
400 TRANSLATION_NO_WRITES_PROVIDED
At least one tag translation row is required.
400 TRANSLATION_INVALID_RESOURCE_ID
A tag ID is invalid.
400 TRANSLATION_LOCALE_NOT_ENABLED
Locale is not enabled for this store.
400 TRANSLATION_DEFAULT_LOCALE_FORBIDDEN
Translations cannot target the store's default locale.
400 TRANSLATION_FIELDS_REQUIRED
Each tag row must contain a translated name.
400 TRANSLATION_FIELD_NOT_TRANSLATABLE
A field is not translatable for tags; only name is, so sending slug returns this error.
400 TRANSLATION_TOO_MANY_FIELDS
The request exceeds the translation field limit.
400 TRANSLATION_STAGING_INVALID_CONTROL_CHARS
A translated value contains unsupported control characters.
400 TRANSLATION_FIELD_VALUE_TOO_LONG
A translated value exceeds the overall translation value limit.
400 TRANSLATION_FIELD_EXCEEDS_BYTE_LIMIT
A translated value exceeds the field's length limit.
400 TRANSLATION_RESOURCE_ID_NOT_IN_STORE
Tag does not exist in this store.
409 TAG_DUPLICATE
Translated name conflicts with another tag in this locale.
409 TRANSLATION_DUPLICATE_NAME_OR_SLUG
Translated name conflicted with another tag during the write.

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

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

import requests

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

Response

200

Sample response

{
  "success": true,
  "code": "TRANSLATION_SAVED",
  "message": "Translation saved."
}

Tag translations updated

EVENT tags/translations/update App scope: read_products Staff permission: products:write

Fired when a tag's translations are added or updated for a locale. The payload contains only the fields that changed. A mixed write that updates some translated fields and clears others fires both translation events. Translation writes do not fire tags/update.

Payload fields

Field	Type	Description
`tag.id`	`integer`	Always present The stable product tag ID.
`tag.name`	`string`	Selectable in the Payload builder The merchant-facing tag name.
`tag.slug`	`string`	Selectable in the Payload builder The tag's URL-safe identifier.
`tag.product_count`	`integer`	Selectable in the Payload builder The number of products currently assigned to the tag.
`tag.created_at`	`string`	Selectable in the Payload builder When the tag was created.
`tag.updated_at`	`string`	Selectable in the Payload builder When the tag's name or slug last changed.
`tag.translations_updated_at`	`string`	Selectable in the Payload builder When any translation for the tag last changed, or null when none exist.
`locale`	`string`	Selectable in the Payload builder The locale whose tag translation changed.
`translation.name`	`string`	Selectable in the Payload builder The updated translated tag name, when present.
`updated_at`	`string`	Selectable in the Payload builder When this locale's tag translation changed.

Payload shape

Sample payload

{
  "locale": "fr",
  "tag": {
    "created_at": "2026-06-09T12:00:00+05:30",
    "id": 7,
    "name": "Summer Sale",
    "product_count": 12,
    "slug": "summer-sale",
    "translations_updated_at": "2026-06-10T09:30:00+05:30",
    "updated_at": "2026-06-09T12:00:00+05:30"
  },
  "translation": {
    "name": "Soldes d’été"
  },
  "updated_at": "2026-06-10T09:30:00+05:30"
}

Tag translations deleted

EVENT tags/translations/delete App scope: read_products Staff permission: products:write

Fired when a tag's translations are cleared for one or more fields in a locale, including when the tag itself is deleted. A mixed write that updates some translated fields and clears others fires both translation events. Translation writes do not fire tags/update.

Payload fields

Field	Type	Description
`tag.id`	`integer`	Always present The stable product tag ID.
`tag.name`	`string`	Selectable in the Payload builder The merchant-facing tag name.
`tag.slug`	`string`	Selectable in the Payload builder The tag's URL-safe identifier.
`tag.product_count`	`integer`	Selectable in the Payload builder The number of products currently assigned to the tag.
`tag.created_at`	`string`	Selectable in the Payload builder When the tag was created.
`tag.updated_at`	`string`	Selectable in the Payload builder When the tag's name or slug last changed.
`tag.translations_updated_at`	`string`	Selectable in the Payload builder When any translation for the tag last changed, or null when none exist.
`locale`	`string`	Selectable in the Payload builder The locale whose tag translation changed.
`translation.name`	`string`	Selectable in the Payload builder An empty string marks a cleared name translation.
`updated_at`	`string`	Selectable in the Payload builder When this locale's tag translation changed.

Payload shape

Sample payload

{
  "locale": "fr",
  "tag": {
    "created_at": "2026-06-09T12:00:00+05:30",
    "id": 7,
    "name": "Summer Sale",
    "product_count": 12,
    "slug": "summer-sale",
    "translations_updated_at": "2026-06-10T09:30:00+05:30",
    "updated_at": "2026-06-09T12:00:00+05:30"
  },
  "translation": {
    "name": ""
  },
  "updated_at": "2026-06-10T09:30:00+05:30"
}

Path parameters

Headers

Errors

Path parameters

Headers

Body parameters

Errors

Path parameters

Query parameters

Headers

Errors

Path parameters

Headers

Body parameters

Errors

Webhook events#

Payload fields

Payload fields