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. 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 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 BLOG_POST_IDS_INVALID
Blog Post 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 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

{
  "data": {
    "fields": {
      "slug": {
        "is_outdated": false,
        "value": "notes-lancement",
        "word_count": 1
      },
      "title": {
        "is_outdated": false,
        "value": "Notes de lancement",
        "word_count": 2
      }
    }
  },
  "success": true
}

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.
`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: `{"title": "Notes de lancement", "slug": "notes-lancement"}`

Errors

400 STORE_API_INVALID_REQUEST_BODY
Request body is not valid JSON.
400 BLOG_POST_IDS_INVALID
Blog Post 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 Post does not exist in this store.
400 TRANSLATION_FIELD_NOT_TRANSLATABLE
Field is not translatable for Blog Posts.
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_NO_SOURCE_TEXT
A non-empty translation requires source text for that field.
409 TRANSLATION_DUPLICATE_NAME_OR_SLUG
Translated title or slug conflicts with another blog post.
400 BLOG_POST_SLUG_FORMAT
Translated slug is not valid for Blog Post URLs.

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": "notes-lancement",
    "title": "Notes de lancement"
  }
}'

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": "notes-lancement",
      "title": "Notes de lancement"
    }
  }),
});
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": "notes-lancement",
            "title": "Notes de lancement",
        },
    },
)
data = res.json()

Response

200

Sample response

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

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. 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 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_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 Post does not exist in this store.
400 TRANSLATION_TOO_MANY_RESOURCES
The request exceeds the translation batch resource cap.
400 BLOG_POST_IDS_INVALID
One post id is not a valid UUID.

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

{
  "data": {
    "resources": {
      "blog_post:5ff7d4ea-3250-4a4d-9d26-07f64d917d31": {
        "title": {
          "is_outdated": false,
          "value": "Notes de lancement",
          "word_count": 2
        }
      }
    }
  },
  "success": true
}

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.
`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": {"title": "Notes de lancement"}}]`

Errors

400 STORE_API_INVALID_REQUEST_BODY
Request body is not valid JSON.
400 BLOG_POST_IDS_INVALID
One post id is not a valid UUID.
400 TRANSLATION_TOO_MANY_FIELDS
The request exceeds the translation batch field cap.
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 Post does not exist in this store.
400 TRANSLATION_FIELD_NOT_TRANSLATABLE
Field is not translatable for Blog Posts.
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_NO_SOURCE_TEXT
A non-empty translation requires source text for that field.
409 TRANSLATION_DUPLICATE_NAME_OR_SLUG
Translated title or slug conflicts with another blog post.
400 BLOG_POST_SLUG_FORMAT
Translated slug is not valid for Blog Post URLs.

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": "Notes de lancement"
      },
      "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": "Notes de lancement"
        },
        "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": "Notes de lancement",
            },
            "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
        }],
    },
)
data = res.json()

Response

200

Sample response

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

Get a blog post metafield translation

GET read_blog + read_translations

Fetch one translated custom-data value.

The definition must be visible and translatable. 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 Post id. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`
`namespace` required	`string`	Metafield definition namespace. Example: `details`
`key` required	`string`	Metafield definition key. Example: `subtitle`
`locale` required	`string`	Enabled non-default store locale. Example: `fr`

Headers

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

Errors

400 PRODUCT_METAFIELD_DEF_NOT_FOUND
The namespace and key do not identify an accessible definition.
404 NOT_FOUND
The resource does not exist in this store.
400 TRANSLATION_FIELD_NOT_TRANSLATABLE
The definition is not translatable.
400 TRANSLATION_LOCALE_REQUIRED
Locale is missing.
400 TRANSLATION_LOCALE_NOT_ENABLED
Locale is not enabled for this store.
400 TRANSLATION_DEFAULT_LOCALE_FORBIDDEN
The default locale cannot be a translation target.
400 TRANSLATION_RESOURCE_ID_NOT_IN_STORE
The translated resource does not exist.

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

Response

200

Sample response

{
  "data": {
    "fields": {
      "value": {
        "is_outdated": false,
        "value": "Été",
        "word_count": 1
      }
    }
  },
  "success": true
}

Set a blog post metafield translation

PUT write_blog + write_translations

Set or clear one translated custom-data value.

Send an empty value to clear the locale's translation. Send an explicit string in value; omit neither the field nor its value, and do not send null. An empty string clears the translation. For list.string, send a JSON-encoded string array with one translated item for each source item, in the same order.

Path parameters

Name	Type	Description
`id` required	`uuid`	Blog Post id. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`
`namespace` required	`string`	Metafield definition namespace. Example: `details`
`key` required	`string`	Metafield definition key. Example: `subtitle`
`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
`value` required	`string`	Translated value; empty clears it. Example: `Lancement`

Errors

400 PRODUCT_METAFIELD_DEF_NOT_FOUND
The namespace and key do not identify an accessible definition.
404 NOT_FOUND
The resource does not exist in this store.
400 TRANSLATION_FIELD_NOT_TRANSLATABLE
The definition is not translatable.
400 TRANSLATION_LOCALE_REQUIRED
Locale is missing.
400 TRANSLATION_LOCALE_NOT_ENABLED
Locale is not enabled for this store.
400 TRANSLATION_DEFAULT_LOCALE_FORBIDDEN
The default locale cannot be a translation target.
400 TRANSLATION_RESOURCE_ID_NOT_IN_STORE
The translated resource does not exist.
400 TRANSLATION_LIST_LENGTH_MISMATCH
The translated list must have the same number of items as the source list.

curl -X PUT 'https://api-store.tringify.com/api/2025-01/blog/posts/5ff7d4ea-3250-4a4d-9d26-07f64d917d31/metafields/details/subtitle/translations/fr' \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "value": "Lancement"
}'

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

Response

200

Sample response

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

Blog post translations updated

EVENT blog_posts/translations/update App scope: read_blog Staff permission: blog:write

Fired when a blog post's translations are added or updated for a locale.

Payload fields

Field	Type	Description
`blog_post.id`	`string`	Always present
`blog_post.title`	`string`	Selectable in the Payload builder
`blog_post.slug`	`string`	Selectable in the Payload builder
`blog_post.content`	`string`	Selectable in the Payload builder
`blog_post.excerpt`	`string`	Selectable in the Payload builder
`blog_post.featured_image_id`	`string`	Selectable in the Payload builder
`blog_post.featured_image_url`	`string`	Selectable in the Payload builder
`blog_post.featured_image_cdn_url`	`string`	Selectable in the Payload builder
`blog_post.author_ref`	`string`	Selectable in the Payload builder
`blog_post.author.id`	`string`	Always present
`blog_post.author.name`	`string`	Selectable in the Payload builder
`blog_post.author.slug`	`string`	Selectable in the Payload builder
`blog_post.author.bio`	`string`	Selectable in the Payload builder
`blog_post.author.avatar_url`	`string`	Selectable in the Payload builder
`blog_post.author.created_at`	`string`	Selectable in the Payload builder
`blog_post.seo_title`	`string`	Selectable in the Payload builder
`blog_post.seo_description`	`string`	Selectable in the Payload builder
`blog_post.template_handle`	`string`	Selectable in the Payload builder
`blog_post.status`	`string`	Selectable in the Payload builder
`blog_post.publish_at`	`string`	Selectable in the Payload builder
`blog_post.published_at`	`string`	Selectable in the Payload builder
`blog_post.comment_count`	`integer`	Selectable in the Payload builder
`blog_post.categories[*].id`	`string`	Always present
`blog_post.categories[*].name`	`string`	Selectable in the Payload builder
`blog_post.categories[*].slug`	`string`	Selectable in the Payload builder
`blog_post.categories[*].description`	`string`	Selectable in the Payload builder
`blog_post.categories[*].seo_title`	`string`	Selectable in the Payload builder
`blog_post.categories[*].seo_description`	`string`	Selectable in the Payload builder
`blog_post.categories[*].template_handle`	`string`	Selectable in the Payload builder
`blog_post.categories[*].post_count`	`integer`	Selectable in the Payload builder
`blog_post.categories[*].created_at`	`string`	Selectable in the Payload builder
`blog_post.categories[*].updated_at`	`string`	Selectable in the Payload builder
`blog_post.tags[*].id`	`string`	Always present
`blog_post.tags[*].name`	`string`	Selectable in the Payload builder
`blog_post.tags[*].slug`	`string`	Selectable in the Payload builder
`blog_post.tags[*].post_count`	`integer`	Selectable in the Payload builder
`blog_post.tags[*].created_at`	`string`	Selectable in the Payload builder
`blog_post.created_at`	`string`	Selectable in the Payload builder
`blog_post.updated_at`	`string`	Selectable in the Payload builder
`locale`	`string`	Selectable in the Payload builder
`translation.title`	`string`	Selectable in the Payload builder
`translation.slug`	`string`	Selectable in the Payload builder
`translation.content`	`string`	Selectable in the Payload builder
`translation.excerpt`	`string`	Selectable in the Payload builder
`translation.seo_title`	`string`	Selectable in the Payload builder
`translation.seo_description`	`string`	Selectable in the Payload builder
`updated_at`	`string`	Selectable in the Payload builder

Payload shape

Sample payload

{
  "blog_post": {
    "author": {
      "avatar_url": "https://assets.tringify.com/74e634ea-84ec-43b8-b66b-986214c2c5a3/upload/8f2a1c2b-9d4e-4a56-b789-0123456789ab.jpg",
      "bio": "Writes product and company updates.",
      "created_at": "2026-06-09T12:00:00+05:30",
      "id": "44bf70b7-88e2-4770-a30e-d7a1db522499",
      "name": "Avery Stone",
      "slug": "avery-stone"
    },
    "author_ref": "44bf70b7-88e2-4770-a30e-d7a1db522499",
    "categories": [
      {
        "created_at": "2026-06-09T12:00:00+05:30",
        "description": "Updates and announcements from the company.",
        "id": "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a",
        "name": "Company News",
        "post_count": 0,
        "seo_description": "Trail notes from 30km in our organic cotton tee.",
        "seo_title": "Field-Testing the Trailblazer Tee",
        "slug": "company-news",
        "template_handle": "default_blog_category",
        "updated_at": "2026-06-09T12:00:00+05:30"
      }
    ],
    "comment_count": 4,
    "content": "\u003cp\u003eWe took the Trailblazer Tee on a 30km ridge hike.\u003c/p\u003e",
    "created_at": "2026-06-09T12:00:00+05:30",
    "excerpt": "We took the Trailblazer Tee on a 30km ridge hike.",
    "featured_image_cdn_url": "",
    "featured_image_id": null,
    "featured_image_url": "",
    "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "publish_at": null,
    "published_at": "2026-06-09T12:00:00+05:30",
    "seo_description": "Trail notes from 30km in our organic cotton tee.",
    "seo_title": "Field-Testing the Trailblazer Tee",
    "slug": "launch-notes",
    "status": "published",
    "tags": [
      {
        "created_at": "2026-06-09T12:00:00+05:30",
        "id": "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93",
        "name": "Launch",
        "post_count": 0,
        "slug": "launch"
      }
    ],
    "template_handle": "default_blog",
    "title": "Launch notes",
    "updated_at": "2026-06-09T12:00:00+05:30"
  },
  "locale": "fr",
  "translation": {
    "content": "\u003cp\u003eDécouvrez les changements de cette version.\u003c/p\u003e",
    "excerpt": "Découvrez les changements de cette version.",
    "seo_description": "Découvrez les dernières notes de lancement.",
    "seo_title": "Notes de lancement",
    "slug": "notes-lancement",
    "title": "Notes de lancement"
  },
  "updated_at": "2026-06-09T12:00:00+05:30"
}

Blog post translations deleted

EVENT blog_posts/translations/delete App scope: read_blog Staff permission: blog:write

Fired when a blog post's translations are cleared for one or more fields in a locale.

Payload fields

Field	Type	Description
`blog_post.id`	`string`	Always present
`blog_post.title`	`string`	Selectable in the Payload builder
`blog_post.slug`	`string`	Selectable in the Payload builder
`blog_post.content`	`string`	Selectable in the Payload builder
`blog_post.excerpt`	`string`	Selectable in the Payload builder
`blog_post.featured_image_id`	`string`	Selectable in the Payload builder
`blog_post.featured_image_url`	`string`	Selectable in the Payload builder
`blog_post.featured_image_cdn_url`	`string`	Selectable in the Payload builder
`blog_post.author_ref`	`string`	Selectable in the Payload builder
`blog_post.author.id`	`string`	Always present
`blog_post.author.name`	`string`	Selectable in the Payload builder
`blog_post.author.slug`	`string`	Selectable in the Payload builder
`blog_post.author.bio`	`string`	Selectable in the Payload builder
`blog_post.author.avatar_url`	`string`	Selectable in the Payload builder
`blog_post.author.created_at`	`string`	Selectable in the Payload builder
`blog_post.seo_title`	`string`	Selectable in the Payload builder
`blog_post.seo_description`	`string`	Selectable in the Payload builder
`blog_post.template_handle`	`string`	Selectable in the Payload builder
`blog_post.status`	`string`	Selectable in the Payload builder
`blog_post.publish_at`	`string`	Selectable in the Payload builder
`blog_post.published_at`	`string`	Selectable in the Payload builder
`blog_post.comment_count`	`integer`	Selectable in the Payload builder
`blog_post.categories[*].id`	`string`	Always present
`blog_post.categories[*].name`	`string`	Selectable in the Payload builder
`blog_post.categories[*].slug`	`string`	Selectable in the Payload builder
`blog_post.categories[*].description`	`string`	Selectable in the Payload builder
`blog_post.categories[*].seo_title`	`string`	Selectable in the Payload builder
`blog_post.categories[*].seo_description`	`string`	Selectable in the Payload builder
`blog_post.categories[*].template_handle`	`string`	Selectable in the Payload builder
`blog_post.categories[*].post_count`	`integer`	Selectable in the Payload builder
`blog_post.categories[*].created_at`	`string`	Selectable in the Payload builder
`blog_post.categories[*].updated_at`	`string`	Selectable in the Payload builder
`blog_post.tags[*].id`	`string`	Always present
`blog_post.tags[*].name`	`string`	Selectable in the Payload builder
`blog_post.tags[*].slug`	`string`	Selectable in the Payload builder
`blog_post.tags[*].post_count`	`integer`	Selectable in the Payload builder
`blog_post.tags[*].created_at`	`string`	Selectable in the Payload builder
`blog_post.created_at`	`string`	Selectable in the Payload builder
`blog_post.updated_at`	`string`	Selectable in the Payload builder
`locale`	`string`	Selectable in the Payload builder
`translation.title`	`string`	Selectable in the Payload builder
`translation.slug`	`string`	Selectable in the Payload builder
`translation.content`	`string`	Selectable in the Payload builder
`translation.excerpt`	`string`	Selectable in the Payload builder
`translation.seo_title`	`string`	Selectable in the Payload builder
`translation.seo_description`	`string`	Selectable in the Payload builder
`updated_at`	`string`	Selectable in the Payload builder

Payload shape

Sample payload

{
  "blog_post": {
    "author": {
      "avatar_url": "https://assets.tringify.com/74e634ea-84ec-43b8-b66b-986214c2c5a3/upload/8f2a1c2b-9d4e-4a56-b789-0123456789ab.jpg",
      "bio": "Writes product and company updates.",
      "created_at": "2026-06-09T12:00:00+05:30",
      "id": "44bf70b7-88e2-4770-a30e-d7a1db522499",
      "name": "Avery Stone",
      "slug": "avery-stone"
    },
    "author_ref": "44bf70b7-88e2-4770-a30e-d7a1db522499",
    "categories": [
      {
        "created_at": "2026-06-09T12:00:00+05:30",
        "description": "Updates and announcements from the company.",
        "id": "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a",
        "name": "Company News",
        "post_count": 0,
        "seo_description": "Trail notes from 30km in our organic cotton tee.",
        "seo_title": "Field-Testing the Trailblazer Tee",
        "slug": "company-news",
        "template_handle": "default_blog_category",
        "updated_at": "2026-06-09T12:00:00+05:30"
      }
    ],
    "comment_count": 4,
    "content": "\u003cp\u003eWe took the Trailblazer Tee on a 30km ridge hike.\u003c/p\u003e",
    "created_at": "2026-06-09T12:00:00+05:30",
    "excerpt": "We took the Trailblazer Tee on a 30km ridge hike.",
    "featured_image_cdn_url": "",
    "featured_image_id": null,
    "featured_image_url": "",
    "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "publish_at": null,
    "published_at": "2026-06-09T12:00:00+05:30",
    "seo_description": "Trail notes from 30km in our organic cotton tee.",
    "seo_title": "Field-Testing the Trailblazer Tee",
    "slug": "launch-notes",
    "status": "published",
    "tags": [
      {
        "created_at": "2026-06-09T12:00:00+05:30",
        "id": "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93",
        "name": "Launch",
        "post_count": 0,
        "slug": "launch"
      }
    ],
    "template_handle": "default_blog",
    "title": "Launch notes",
    "updated_at": "2026-06-09T12:00:00+05:30"
  },
  "locale": "fr",
  "translation": {
    "content": "",
    "excerpt": "",
    "seo_description": "",
    "seo_title": "",
    "slug": "",
    "title": ""
  },
  "updated_at": "2026-06-09T12:00:00+05:30"
}

Blog post metafield translations updated

EVENT blog_post_metafields/translations/update App scope: read_blog Staff permission: blog:write

Fired when a blog post metafield's translation is added or updated for a locale.

Payload fields

Field	Type	Description
`metafield.blog_post_id`	`string`	Always present
`metafield.blog_post_title`	`string`	Selectable in the Payload builder
`metafield.blog_post_slug`	`string`	Selectable in the Payload builder
`metafield.definition_id`	`string`	Always present
`metafield.namespace`	`string`	Selectable in the Payload builder
`metafield.key`	`string`	Selectable in the Payload builder
`metafield.name`	`string`	Selectable in the Payload builder
`metafield.type`	`string`	Selectable in the Payload builder
`metafield.app_id`	`string`	Selectable in the Payload builder
`metafield.app_access`	`string`	Selectable in the Payload builder
`metafield.merchant_access`	`string`	Selectable in the Payload builder
`locale`	`string`	Selectable in the Payload builder
`translation.value`	`string`	Selectable in the Payload builder
`updated_at`	`string`	Selectable in the Payload builder

Payload shape

Sample payload

{
  "locale": "fr",
  "metafield": {
    "app_access": "shared",
    "app_id": null,
    "blog_post_id": "...",
    "blog_post_slug": "...",
    "blog_post_title": "...",
    "definition_id": "...",
    "key": "...",
    "merchant_access": "read_write",
    "name": "...",
    "namespace": "...",
    "type": "string"
  },
  "translation": {
    "value": "5 minutes"
  },
  "updated_at": "2026-06-09T12:00:00+05:30"
}

Blog post metafield translations deleted

EVENT blog_post_metafields/translations/delete App scope: read_blog Staff permission: blog:write

Fired when a blog post metafield's translation is cleared for a locale, including when its blog post is deleted.

Payload fields

Field	Type	Description
`metafield.blog_post_id`	`string`	Always present
`metafield.blog_post_title`	`string`	Selectable in the Payload builder
`metafield.blog_post_slug`	`string`	Selectable in the Payload builder
`metafield.definition_id`	`string`	Always present
`metafield.namespace`	`string`	Selectable in the Payload builder
`metafield.key`	`string`	Selectable in the Payload builder
`metafield.name`	`string`	Selectable in the Payload builder
`metafield.type`	`string`	Selectable in the Payload builder
`metafield.app_id`	`string`	Selectable in the Payload builder
`metafield.app_access`	`string`	Selectable in the Payload builder
`metafield.merchant_access`	`string`	Selectable in the Payload builder
`locale`	`string`	Selectable in the Payload builder
`translation.value`	`string`	Selectable in the Payload builder
`updated_at`	`string`	Selectable in the Payload builder

Payload shape

Sample payload

{
  "locale": "fr",
  "metafield": {
    "app_access": "shared",
    "app_id": null,
    "blog_post_id": "...",
    "blog_post_slug": "...",
    "blog_post_title": "...",
    "definition_id": "...",
    "key": "...",
    "merchant_access": "read_write",
    "name": "...",
    "namespace": "...",
    "type": "string"
  },
  "translation": {
    "value": ""
  },
  "updated_at": "2026-06-09T12:00: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

Path parameters

Headers

Errors

Path parameters

Headers

Body parameters

Errors

Webhook events#

Payload fields

Payload fields

Payload fields

Payload fields