Blog Post translations

Get blog post translation

GET read_blog + read_translations

Fetch one blog post translation.

Returns stored translated Blog Post fields for one locale, including whether the translation is out of date.

Path parameters

Name	Type	Description
`id` required	`uuid`	Blog Post 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 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for Blog Posts.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.

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

Response

200

Sample response

{
  "success": true,
  "data": {
    "fields": {
      "title": {
        "value": "Launch notes",
        "is_outdated": false,
        "word_count": 2
      },
      "slug": {
        "value": "launch-notes",
        "is_outdated": false,
        "word_count": 1
      }
    }
  }
}

Set blog post translation

PUT write_blog + write_translations

Set one blog post translation.

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

Path parameters

Name	Type	Description
`id` required	`uuid`	Blog Post 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.

Body parameters

Name	Type	Description
`translations` required	`object`	Field-keyed translation values. Allowed fields come from `contract.translation.fields`. Example: `{"title": "Launch notes", "slug": "launch-notes"}`

Errors

400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for Blog Posts.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.

curl -X PUT https://api-store.tringify.com/api/2025-01/blog/posts/5ff7d4ea-3250-4a4d-9d26-07f64d917d31/translations/fr \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "translations": {
    "slug": "launch-notes",
    "title": "Launch notes"
  }
}'

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

import requests

res = requests.put(
    "https://api-store.tringify.com/api/2025-01/blog/posts/5ff7d4ea-3250-4a4d-9d26-07f64d917d31/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "translations": {
            "slug": "launch-notes",
            "title": "Launch notes",
        },
    },
)
data = res.json()

Response

200

Sample response

{
  "success": true,
  "data": {
    "resource_type": "blog_post",
    "resource_id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "locale": "es",
    "saved_fields": ["title", "slug"]
  }
}

Batch get blog post translations

GET read_blog + read_translations

Fetch blog post translations in batch.

Returns translated Blog Post fields for multiple post 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 Blog Post 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_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for Blog Posts.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.

curl https://api-store.tringify.com/api/2025-01/blog/posts/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/posts/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/posts/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

{
  "success": true,
  "data": {
    "translations": [
      {
        "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
        "fields": {
          "title": {
            "value": "Launch notes",
            "is_outdated": false,
            "word_count": 2
          }
        }
      }
    ]
  }
}

Batch set blog post translations

PUT write_blog + write_translations

Set blog post translations in batch.

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

Errors

400 TRANSLATION_INVALID_LOCALE
Locale is not enabled or is the default locale.
400 TRANSLATION_INVALID_FIELD
Field is not translatable for Blog Posts.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.

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

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/posts/translations/fr", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "translations": [
      {
        "fields": {
          "title": "Launch notes"
        },
        "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/posts/translations/fr",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "translations": [{
            "fields": {
                "title": "Launch notes",
            },
            "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
        }],
    },
)
data = res.json()

Response

200

Sample response

{
  "success": true,
  "data": {
    "saved": 1,
    "failed": 0
  }
}