Blog Author translations

Get blog author translation

GET read_blog + read_translations

Fetch one blog author translation.

Returns stored translated Blog Author fields for one locale, including whether the translation is out of date. 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	`uuid`	Blog Author id. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`
`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_REQUEST_BODY
Blog Author id is not a valid UUID.
400 TRANSLATION_LOCALE_REQUIRED
Locale is required.
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
Blog Author does not exist in this store.

curl 'https://api-store.tringify.com/api/2025-01/blog/authors/5ff7d4ea-3250-4a4d-9d26-07f64d917d31/translations/fr' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/authors/5ff7d4ea-3250-4a4d-9d26-07f64d917d31/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/blog/authors/5ff7d4ea-3250-4a4d-9d26-07f64d917d31/translations/fr",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "fields": {
      "bio": {
        "is_outdated": false,
        "value": "Writer",
        "word_count": 1
      },
      "name": {
        "is_outdated": false,
        "value": "Updates",
        "word_count": 1
      }
    }
  },
  "success": true
}

Set blog author translation

PUT write_blog + write_translations

Set one blog author translation.

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

Path parameters

Name	Type	Description
`id` required	`uuid`	Blog Author id. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`
`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. Allowed fields come from `contract.translation.fields`. Example: `{"name": "Updates", "bio": "Writer"}`

Errors

400 STORE_API_INVALID_REQUEST_BODY
Request body is not valid JSON.
400 TRANSLATION_LOCALE_REQUIRED
Locale is required.
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
Blog Author does not exist in this store.
400 TRANSLATION_FIELD_NOT_TRANSLATABLE
Field is not translatable for Blog Authors.
400 TRANSLATION_FIELDS_REQUIRED
At least one translated field is required.
400 TRANSLATION_FIELD_VALUE_TOO_LONG
A translated value exceeds its field limit.

curl -X PUT 'https://api-store.tringify.com/api/2025-01/blog/authors/5ff7d4ea-3250-4a4d-9d26-07f64d917d31/translations/fr' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "translations": {
    "bio": "Writer",
    "name": "Updates"
  }
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/authors/5ff7d4ea-3250-4a4d-9d26-07f64d917d31/translations/fr", {
  method: "PUT",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN","Content-Type":"application/json"},
  body: JSON.stringify({
    "translations": {
      "bio": "Writer",
      "name": "Updates"
    }
  }),
});
const data = await res.json();

import requests

res = requests.put(
    "https://api-store.tringify.com/api/2025-01/blog/authors/5ff7d4ea-3250-4a4d-9d26-07f64d917d31/translations/fr",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
    json={
        "translations": {
            "bio": "Writer",
            "name": "Updates",
        },
    },
)
data = res.json()

Response

200

Sample response

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

Batch get blog author translations

GET read_blog + read_translations

Fetch blog author translations in batch.

Returns translated Blog Author fields for multiple author ids in one locale. 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 Blog Author ids. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31,3a588f80-fd8c-4d46-af1b-00a1c4a7f85a`

Headers

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

Errors

400 TRANSLATION_LOCALE_REQUIRED
Locale is required.
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
Blog Author does not exist in this store.
400 TRANSLATION_TOO_MANY_RESOURCES
The request exceeds the translation batch resource cap.

curl 'https://api-store.tringify.com/api/2025-01/blog/authors/translations/fr?ids=5ff7d4ea-3250-4a4d-9d26-07f64d917d31,3a588f80-fd8c-4d46-af1b-00a1c4a7f85a' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/authors/translations/fr?ids=5ff7d4ea-3250-4a4d-9d26-07f64d917d31,3a588f80-fd8c-4d46-af1b-00a1c4a7f85a", {
  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/blog/authors/translations/fr?ids=5ff7d4ea-3250-4a4d-9d26-07f64d917d31,3a588f80-fd8c-4d46-af1b-00a1c4a7f85a",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "resources": {
      "blog_author:5ff7d4ea-3250-4a4d-9d26-07f64d917d31": {
        "bio": {
          "is_outdated": false,
          "value": "Writer",
          "word_count": 1
        },
        "name": {
          "is_outdated": false,
          "value": "Updates",
          "word_count": 1
        }
      }
    }
  },
  "success": true
}

Batch set blog author translations

PUT write_blog + write_translations

Set blog author translations in batch.

Writes translated Blog Author fields for multiple author 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.
`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`. Allowed field keys come from `contract.translation.fields`. Example: `[{"id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31", "fields": {"name": "Updates"}}]`

Errors

400 STORE_API_INVALID_REQUEST_BODY
Request body is not valid JSON.
400 TRANSLATION_LOCALE_REQUIRED
Locale is required.
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
Blog Author does not exist in this store.
400 TRANSLATION_FIELD_NOT_TRANSLATABLE
Field is not translatable for Blog Authors.
400 TRANSLATION_FIELDS_REQUIRED
At least one translated field is required.
400 TRANSLATION_FIELD_VALUE_TOO_LONG
A translated value exceeds its field limit.
400 TRANSLATION_TOO_MANY_RESOURCES
The request exceeds the translation batch resource cap.

curl -X PUT 'https://api-store.tringify.com/api/2025-01/blog/authors/translations/fr' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "translations": [
    {
      "fields": {
        "name": "Updates"
      },
      "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    }
  ]
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/authors/translations/fr", {
  method: "PUT",
  headers: {"Authorization":"Bearer YOUR_STORE_API_TOKEN","Content-Type":"application/json"},
  body: JSON.stringify({
    "translations": [
      {
        "fields": {
          "name": "Updates"
        },
        "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
      }
    ]
  }),
});
const data = await res.json();

import requests

res = requests.put(
    "https://api-store.tringify.com/api/2025-01/blog/authors/translations/fr",
    headers={"Authorization":"Bearer YOUR_STORE_API_TOKEN"},
    json={
        "translations": [{
            "fields": {
                "name": "Updates",
            },
            "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
        }],
    },
)
data = res.json()

Response

200

Sample response

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