Blog Posts

Blog Post limits

GET read_blog

Fetch Blog Post limits and per-field constraints.

Returns the per-field maximum lengths, enum values, and request caps that apply to Blog Post endpoints.

Headers

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

curl https://api-store.tringify.com/api/2025-01/blog/posts/limits \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

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

Response

200

Sample response

{
  "data": {
    "fields": {
      "content": {
        "max_length": 100000
      },
      "excerpt": {
        "max_length": 500
      },
      "seo_description": {
        "max_length": 500
      },
      "seo_title": {
        "max_length": 255
      },
      "slug": {
        "max_length": 200
      },
      "title": {
        "max_length": 200
      }
    },
    "request_caps": {
      "bulk_max": 100,
      "list_max_limit": 200,
      "max_categories_per_post": 20,
      "max_per_store": 5000,
      "max_tags_per_post": 20,
      "search_max_length": 100,
      "search_max_limit": 50,
      "slug_retry_max": 100,
      "sort_columns": [
        "title",
        "status",
        "author",
        "comment_count",
        "published_at",
        "publish_at",
        "created_at",
        "updated_at"
      ],
      "statuses": [
        "draft",
        "scheduled",
        "published",
        "archived"
      ]
    },
    "resource_type": "blog_post"
  },
  "success": true
}

List blog posts

GET read_blog

List blog posts for the store.

Returns paginated Blog Posts. Filter by search, status, author, category, tag, or publication date. Invalid pagination, UUID, and sort parameters are rejected instead of silently defaulted.

Query parameters

Name	Type	Description
`page`	`integer`	Page number. Example: `1`
`limit`	`integer`	Page size. Example: `20`
`search`	`string`	Search Blog Posts by title or slug. Example: `launch-notes`
`status`	`string`	Filter by status. Example: `published`
`author_ref`	`uuid`	Filter by blog author id. Example: `44bf70b7-88e2-4770-a30e-d7a1db522499`
`category_id`	`uuid`	Filter by assigned blog category id. Example: `3a588f80-fd8c-4d46-af1b-00a1c4a7f85a`
`tag_id`	`uuid`	Filter by assigned blog tag id. Example: `6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93`
`publication_date_from`	`date`	Include posts published or scheduled on or after this store-local date (YYYY-MM-DD). Example: `2026-02-01`
`publication_date_to`	`date`	Include posts published or scheduled on or before this store-local date (YYYY-MM-DD). Example: `2026-02-28`
`sort_by`	`string`	Sort field from the Blog Post list contract. Allowed values `titlestatusauthorcomment_countpublished_atpublish_atcreated_atupdated_at` Example: `created_at`
`sort_direction`	`string`	Sort direction from the Blog Post list contract. Allowed values `ascdesc` Example: `desc`

Headers

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

Errors

400 VALIDATION_LIST_INVALID_PAGE
Page must be a positive integer.
400 VALIDATION_LIST_INVALID_LIMIT
Limit must be within the Blog Post contract cap.
400 VALIDATION_LIST_INVALID_SORT_BY
Sort field is not supported.
400 VALIDATION_LIST_INVALID_SORT_DIRECTION
Sort direction must be asc or desc.
400 BLOG_POST_SEARCH_TOO_LONG
Search exceeds the Blog Post contract max length.
400 BLOG_POST_STATUS_FILTER_INVALID
Status is not one of the allowed values.
400 BLOG_POST_PUBLICATION_DATE_FILTER_INVALID
Publication dates must use YYYY-MM-DD and form a valid range.
400 STORE_API_INVALID_REQUEST_BODY
An author id is not a UUID.
400 STORE_API_INVALID_CATEGORY_ID
Category id is not a UUID.
400 STORE_API_INVALID_TAG_ID
Tag id is not a UUID.

curl https://api-store.tringify.com/api/2025-01/blog/posts?author_ref=44bf70b7-88e2-4770-a30e-d7a1db522499&category_id=3a588f80-fd8c-4d46-af1b-00a1c4a7f85a&limit=20&page=1&publication_date_from=2026-02-01&publication_date_to=2026-02-28&search=launch-notes&sort_by=created_at&sort_direction=desc&status=published&tag_id=6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93 \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/posts?author_ref=44bf70b7-88e2-4770-a30e-d7a1db522499&category_id=3a588f80-fd8c-4d46-af1b-00a1c4a7f85a&limit=20&page=1&publication_date_from=2026-02-01&publication_date_to=2026-02-28&search=launch-notes&sort_by=created_at&sort_direction=desc&status=published&tag_id=6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93", {
  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?author_ref=44bf70b7-88e2-4770-a30e-d7a1db522499&category_id=3a588f80-fd8c-4d46-af1b-00a1c4a7f85a&limit=20&page=1&publication_date_from=2026-02-01&publication_date_to=2026-02-28&search=launch-notes&sort_by=created_at&sort_direction=desc&status=published&tag_id=6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "items": [
      {
        "author": {
          "avatar_cdn_url": "https://cdn.example.com/avery.jpg",
          "avatar_media_id": "f_author_avatar",
          "avatar_url": "https://store.example.com/files/avery.jpg",
          "bio": "Writes product and company updates.",
          "created_at": "2026-01-02T10:00:00Z",
          "id": "44bf70b7-88e2-4770-a30e-d7a1db522499",
          "name": "Avery Stone",
          "post_count": 4,
          "slug": "avery-stone",
          "updated_at": "2026-02-09T15:30:00Z"
        },
        "categories": [
          {
            "id": "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a",
            "name": "Company News",
            "slug": "company-news"
          }
        ],
        "category_count": 1,
        "comment_count": 3,
        "created_at": "2026-01-05T12:00:00Z",
        "excerpt": "What changed in this release.",
        "featured_image_cdn_url": "https://cdn.example.com/launch.jpg",
        "featured_image_id": "f_8f2a1c2b9d4e",
        "featured_image_url": "https://cdn.example.com/launch.jpg",
        "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
        "publish_at": "2026-02-10T09:00:00",
        "published_at": "2026-02-10T09:00:00Z",
        "slug": "launch-notes",
        "status": "published",
        "storefront_url": "https://store.example.com/blog/launch-notes",
        "tags": [],
        "title": "Launch notes",
        "updated_at": "2026-01-05T12:00:00Z"
      }
    ],
    "limit": 20,
    "page": 1,
    "sort_by": "created_at",
    "sort_direction": "desc",
    "total": 1
  },
  "success": true
}

Search blog posts

GET read_blog

Search blog posts for picker UIs.

Returns lightweight post options. limit is strict and capped by the Blog Post contract.

Query parameters

Name	Type	Description
`q`	`string`	Search query. Example: `launch`
`status`	`string`	Filter by status. Example: `published`
`limit`	`integer`	Suggestion count. Example: `10`
`offset`	`integer`	Result offset. Example: `0`

Headers

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

curl https://api-store.tringify.com/api/2025-01/blog/posts/search?limit=10&offset=0&q=launch&status=published \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN"

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/posts/search?limit=10&offset=0&q=launch&status=published", {
  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/search?limit=10&offset=0&q=launch&status=published",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "has_more": false,
    "options": [
      {
        "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
        "name": "Launch notes"
      }
    ],
    "total": 1
  },
  "success": true
}

Get a blog post

GET read_blog

Fetch one blog post by id.

Returns the Blog Post if it belongs to the token's store.

Path parameters

Name	Type	Description
`id` required	`uuid`	Blog Post id. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`

Headers

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

Errors

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 \
  -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", {
  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",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "author": {
      "avatar_cdn_url": "https://cdn.example.com/avery.jpg",
      "avatar_media_id": "f_author_avatar",
      "avatar_url": "https://store.example.com/files/avery.jpg",
      "bio": "Writes product and company updates.",
      "created_at": "2026-01-02T10:00:00Z",
      "id": "44bf70b7-88e2-4770-a30e-d7a1db522499",
      "name": "Avery Stone",
      "post_count": 4,
      "slug": "avery-stone",
      "updated_at": "2026-02-09T15:30:00Z"
    },
    "author_ref": "44bf70b7-88e2-4770-a30e-d7a1db522499",
    "categories": [
      {
        "id": "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a",
        "name": "Company News",
        "slug": "company-news"
      }
    ],
    "category_count": 1,
    "category_ids": [
      "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"
    ],
    "comment_count": 3,
    "content": "\u003cp\u003eWhat changed in this release.\u003c/p\u003e",
    "created_at": "2026-01-05T12:00:00Z",
    "excerpt": "What changed in this release.",
    "featured_image_cdn_url": "https://cdn.example.com/launch.jpg",
    "featured_image_id": "f_8f2a1c2b9d4e",
    "featured_image_url": "https://cdn.example.com/launch.jpg",
    "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "publish_at": "2026-02-10T09:00:00",
    "publish_at_iso": "2026-02-10T09:00:00-05:00",
    "published_at": "2026-02-10T09:00:00Z",
    "seo_description": "Read the latest launch notes.",
    "seo_title": "Launch notes",
    "slug": "launch-notes",
    "status": "published",
    "storefront_url": "https://store.example.com/blog/launch-notes",
    "tag_ids": [
      "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"
    ],
    "tags": [
      {
        "id": "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93",
        "name": "Launch",
        "slug": "launch"
      }
    ],
    "template_handle": "default_blog",
    "title": "Launch notes",
    "updated_at": "2026-01-05T12:00:00Z"
  },
  "success": true
}

Creates a Blog Post. title, author_ref, and status are required. author_ref must identify an author in this store. slug is optional on create; when omitted or empty, the backend generates it from the title.

Headers

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

Body parameters

Name	Type	Description
`title` required	`string`	Blog Post title. Example: `Launch notes`
`slug`	`string`	Optional slug. Omit to generate from title. Example: `launch-notes`
`content`	`string`	Optional sanitized HTML content. Example: `<p>What changed in this release.</p>`
`excerpt`	`string`	Optional excerpt. Example: `What changed in this release.`
`featured_image_id`	`string`	Optional image file id. Non-empty values must reference an image in this store. Example: `f_8f2a1c2b9d4e`
`author_ref` required	`uuid`	Store-scoped blog author id. Example: `44bf70b7-88e2-4770-a30e-d7a1db522499`
`seo_title`	`string`	Optional SEO title. Example: `Launch notes`
`seo_description`	`string`	Optional SEO description. Example: `Read the latest launch notes.`
`status` required	`string`	Post status: draft, scheduled, published, or archived. Example: `published`
`publish_at`	`string`	Store-time publish date. Required when status is scheduled. Example: `2026-02-10T09:00:00`
`template_handle`	`string`	Template assignment. On create, omitting this field or sending an empty string assigns `default_blog`. Use `default_blog` for the default Blog Post template, or pass an alternate Blog Post template handle configured for the store. On update, omit `template_handle` to leave the assignment unchanged, use `default_blog` to reset it to default, and do not send an empty string. Example: `default_blog`
`category_ids`	`array<uuid>`	Category ids to assign. Example: `3a588f80-fd8c-4d46-af1b-00a1c4a7f85a`
`tag_ids`	`array<uuid>`	Tag ids to assign. Example: `6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93`

Errors

400 BLOG_POST_AUTHOR_REQUIRED
Author is required.
400 BLOG_POST_TITLE_REQUIRED
Title is empty after normalization.
400 BLOG_POST_TITLE_TOO_LONG
Title exceeds the Blog Post contract max length.
400 BLOG_POST_SLUG_REQUIRED
Slug is empty on update. Blank slug auto-generation is only available on create.
400 BLOG_POST_SLUG_FORMAT
Slug is not valid for Blog Post URLs.
400 BLOG_POST_SLUG_TOO_LONG
Slug exceeds the Blog Post contract max length.
404 BLOG_AUTHOR_NOT_FOUND
Author does not exist in this store.
400 BLOG_POST_CONTENT_TOO_LONG
Content exceeds the Blog Post contract max length.
400 BLOG_POST_EXCERPT_TOO_LONG
Excerpt exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_TITLE_TOO_LONG
SEO title exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_DESCRIPTION_TOO_LONG
SEO description exceeds the Blog Post contract max length.
400 BLOG_POST_STATUS_INVALID
Status is not one of the allowed values.
400 BLOG_POST_PUBLISH_DATE_REQUIRED
Scheduled posts require publish_at.
400 BLOG_POST_CATEGORY_IDS_INVALID
One or more category ids do not exist in this store.
400 BLOG_POST_TAG_IDS_INVALID
One or more tag ids do not exist in this store.
400 TEMPLATE_HANDLE_INVALID
Template handle is not valid for Blog Post templates.
400 TEMPLATE_HANDLE_NOT_FOUND
Template handle does not exist on the store's primary active theme for Blog Post.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.
409 BLOG_POST_SLUG_DUPLICATE
Slug already exists in this store.

curl -X POST https://api-store.tringify.com/api/2025-01/blog/posts \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "author_ref": "44bf70b7-88e2-4770-a30e-d7a1db522499",
  "category_ids": [
    "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"
  ],
  "content": "\u003cp\u003eWhat changed in this release.\u003c/p\u003e",
  "excerpt": "What changed in this release.",
  "featured_image_id": "f_8f2a1c2b9d4e",
  "publish_at": "2026-02-10T09:00:00",
  "seo_description": "Read the latest launch notes.",
  "seo_title": "Launch notes",
  "slug": "launch-notes",
  "status": "published",
  "tag_ids": [
    "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"
  ],
  "template_handle": "default_blog",
  "title": "Launch notes"
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/posts", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "author_ref": "44bf70b7-88e2-4770-a30e-d7a1db522499",
    "category_ids": [
      "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"
    ],
    "content": "\u003cp\u003eWhat changed in this release.\u003c/p\u003e",
    "excerpt": "What changed in this release.",
    "featured_image_id": "f_8f2a1c2b9d4e",
    "publish_at": "2026-02-10T09:00:00",
    "seo_description": "Read the latest launch notes.",
    "seo_title": "Launch notes",
    "slug": "launch-notes",
    "status": "published",
    "tag_ids": [
      "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"
    ],
    "template_handle": "default_blog",
    "title": "Launch notes"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    "https://api-store.tringify.com/api/2025-01/blog/posts",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "author_ref": "44bf70b7-88e2-4770-a30e-d7a1db522499",
        "category_ids": ["3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"],
        "content": "<p>What changed in this release.</p>",
        "excerpt": "What changed in this release.",
        "featured_image_id": "f_8f2a1c2b9d4e",
        "publish_at": "2026-02-10T09:00:00",
        "seo_description": "Read the latest launch notes.",
        "seo_title": "Launch notes",
        "slug": "launch-notes",
        "status": "published",
        "tag_ids": ["6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"],
        "template_handle": "default_blog",
        "title": "Launch notes",
    },
)
data = res.json()

Response

201

Sample response

{
  "data": {
    "author": {
      "avatar_cdn_url": "https://cdn.example.com/avery.jpg",
      "avatar_media_id": "f_author_avatar",
      "avatar_url": "https://store.example.com/files/avery.jpg",
      "bio": "Writes product and company updates.",
      "created_at": "2026-01-02T10:00:00Z",
      "id": "44bf70b7-88e2-4770-a30e-d7a1db522499",
      "name": "Avery Stone",
      "post_count": 4,
      "slug": "avery-stone",
      "updated_at": "2026-02-09T15:30:00Z"
    },
    "author_ref": "44bf70b7-88e2-4770-a30e-d7a1db522499",
    "categories": [
      {
        "id": "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a",
        "name": "Company News",
        "slug": "company-news"
      }
    ],
    "category_count": 1,
    "category_ids": [
      "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"
    ],
    "comment_count": 3,
    "content": "\u003cp\u003eWhat changed in this release.\u003c/p\u003e",
    "created_at": "2026-01-05T12:00:00Z",
    "excerpt": "What changed in this release.",
    "featured_image_cdn_url": "https://cdn.example.com/launch.jpg",
    "featured_image_id": "f_8f2a1c2b9d4e",
    "featured_image_url": "https://cdn.example.com/launch.jpg",
    "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "publish_at": "2026-02-10T09:00:00",
    "publish_at_iso": "2026-02-10T09:00:00-05:00",
    "published_at": "2026-02-10T09:00:00Z",
    "seo_description": "Read the latest launch notes.",
    "seo_title": "Launch notes",
    "slug": "launch-notes",
    "status": "published",
    "storefront_url": "https://store.example.com/blog/launch-notes",
    "tag_ids": [
      "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"
    ],
    "tags": [
      {
        "id": "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93",
        "name": "Launch",
        "slug": "launch"
      }
    ],
    "template_handle": "default_blog",
    "title": "Launch notes",
    "updated_at": "2026-01-05T12:00:00Z"
  },
  "success": true
}

Update a blog post

PUT write_blog

Update a blog post.

Updates provided Blog Post fields. Omitted fields are left unchanged. When slug is provided it must be non-empty and valid; create is the only path that auto-generates a blank slug from the title.

Path parameters

Name	Type	Description
`id` required	`uuid`	Blog Post id. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`

Headers

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

Body parameters

Name	Type	Description
`title`	`string`	Blog Post title. Example: `Launch notes`
`slug`	`string`	Optional slug. Omit to generate from title. Example: `launch-notes`
`content`	`string`	Optional sanitized HTML content. Example: `<p>What changed in this release.</p>`
`excerpt`	`string`	Optional excerpt. Example: `What changed in this release.`
`featured_image_id`	`string`	Optional image file id. Non-empty values must reference an image in this store. Example: `f_8f2a1c2b9d4e`
`author_ref`	`uuid`	Store-scoped blog author id. Example: `44bf70b7-88e2-4770-a30e-d7a1db522499`
`seo_title`	`string`	Optional SEO title. Example: `Launch notes`
`seo_description`	`string`	Optional SEO description. Example: `Read the latest launch notes.`
`status`	`string`	Post status: draft, scheduled, published, or archived. Example: `published`
`publish_at`	`string`	Store-time publish date. Required when status is scheduled. Example: `2026-02-10T09:00:00`
`template_handle`	`string`	Template assignment. On create, omitting this field or sending an empty string assigns `default_blog`. Use `default_blog` for the default Blog Post template, or pass an alternate Blog Post template handle configured for the store. On update, omit `template_handle` to leave the assignment unchanged, use `default_blog` to reset it to default, and do not send an empty string. Example: `default_blog`
`category_ids`	`array<uuid>`	Category ids to assign. Example: `3a588f80-fd8c-4d46-af1b-00a1c4a7f85a`
`tag_ids`	`array<uuid>`	Tag ids to assign. Example: `6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93`
`create_redirect`	`boolean`	When slug changes, create a redirect from the previous post URL. Defaults to true; set false to suppress it. Example: `true`

Errors

400 BLOG_POST_AUTHOR_REQUIRED
Author is required.
400 BLOG_POST_TITLE_REQUIRED
Title is empty after normalization.
400 BLOG_POST_TITLE_TOO_LONG
Title exceeds the Blog Post contract max length.
400 BLOG_POST_SLUG_REQUIRED
Slug is empty on update. Blank slug auto-generation is only available on create.
400 BLOG_POST_SLUG_FORMAT
Slug is not valid for Blog Post URLs.
400 BLOG_POST_SLUG_TOO_LONG
Slug exceeds the Blog Post contract max length.
404 BLOG_AUTHOR_NOT_FOUND
Author does not exist in this store.
400 BLOG_POST_CONTENT_TOO_LONG
Content exceeds the Blog Post contract max length.
400 BLOG_POST_EXCERPT_TOO_LONG
Excerpt exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_TITLE_TOO_LONG
SEO title exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_DESCRIPTION_TOO_LONG
SEO description exceeds the Blog Post contract max length.
400 BLOG_POST_STATUS_INVALID
Status is not one of the allowed values.
400 BLOG_POST_PUBLISH_DATE_REQUIRED
Scheduled posts require publish_at.
400 BLOG_POST_CATEGORY_IDS_INVALID
One or more category ids do not exist in this store.
400 BLOG_POST_TAG_IDS_INVALID
One or more tag ids do not exist in this store.
400 TEMPLATE_HANDLE_INVALID
Template handle is not valid for Blog Post templates.
400 TEMPLATE_HANDLE_NOT_FOUND
Template handle does not exist on the store's primary active theme for Blog Post.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.
409 BLOG_POST_SLUG_DUPLICATE
Slug already exists in this store.

curl -X PUT https://api-store.tringify.com/api/2025-01/blog/posts/5ff7d4ea-3250-4a4d-9d26-07f64d917d31 \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "author_ref": "44bf70b7-88e2-4770-a30e-d7a1db522499",
  "category_ids": [
    "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"
  ],
  "content": "\u003cp\u003eWhat changed in this release.\u003c/p\u003e",
  "create_redirect": true,
  "excerpt": "What changed in this release.",
  "featured_image_id": "f_8f2a1c2b9d4e",
  "publish_at": "2026-02-10T09:00:00",
  "seo_description": "Read the latest launch notes.",
  "seo_title": "Launch notes",
  "slug": "launch-notes",
  "status": "published",
  "tag_ids": [
    "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"
  ],
  "template_handle": "default_blog",
  "title": "Launch notes"
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/posts/5ff7d4ea-3250-4a4d-9d26-07f64d917d31", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "author_ref": "44bf70b7-88e2-4770-a30e-d7a1db522499",
    "category_ids": [
      "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"
    ],
    "content": "\u003cp\u003eWhat changed in this release.\u003c/p\u003e",
    "create_redirect": true,
    "excerpt": "What changed in this release.",
    "featured_image_id": "f_8f2a1c2b9d4e",
    "publish_at": "2026-02-10T09:00:00",
    "seo_description": "Read the latest launch notes.",
    "seo_title": "Launch notes",
    "slug": "launch-notes",
    "status": "published",
    "tag_ids": [
      "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"
    ],
    "template_handle": "default_blog",
    "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",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "author_ref": "44bf70b7-88e2-4770-a30e-d7a1db522499",
        "category_ids": ["3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"],
        "content": "<p>What changed in this release.</p>",
        "create_redirect": True,
        "excerpt": "What changed in this release.",
        "featured_image_id": "f_8f2a1c2b9d4e",
        "publish_at": "2026-02-10T09:00:00",
        "seo_description": "Read the latest launch notes.",
        "seo_title": "Launch notes",
        "slug": "launch-notes",
        "status": "published",
        "tag_ids": ["6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"],
        "template_handle": "default_blog",
        "title": "Launch notes",
    },
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "author": {
      "avatar_cdn_url": "https://cdn.example.com/avery.jpg",
      "avatar_media_id": "f_author_avatar",
      "avatar_url": "https://store.example.com/files/avery.jpg",
      "bio": "Writes product and company updates.",
      "created_at": "2026-01-02T10:00:00Z",
      "id": "44bf70b7-88e2-4770-a30e-d7a1db522499",
      "name": "Avery Stone",
      "post_count": 4,
      "slug": "avery-stone",
      "updated_at": "2026-02-09T15:30:00Z"
    },
    "author_ref": "44bf70b7-88e2-4770-a30e-d7a1db522499",
    "categories": [
      {
        "id": "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a",
        "name": "Company News",
        "slug": "company-news"
      }
    ],
    "category_count": 1,
    "category_ids": [
      "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"
    ],
    "comment_count": 3,
    "content": "\u003cp\u003eWhat changed in this release.\u003c/p\u003e",
    "created_at": "2026-01-05T12:00:00Z",
    "excerpt": "What changed in this release.",
    "featured_image_cdn_url": "https://cdn.example.com/launch.jpg",
    "featured_image_id": "f_8f2a1c2b9d4e",
    "featured_image_url": "https://cdn.example.com/launch.jpg",
    "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "publish_at": "2026-02-10T09:00:00",
    "publish_at_iso": "2026-02-10T09:00:00-05:00",
    "published_at": "2026-02-10T09:00:00Z",
    "seo_description": "Read the latest launch notes.",
    "seo_title": "Launch notes",
    "slug": "launch-notes",
    "status": "published",
    "storefront_url": "https://store.example.com/blog/launch-notes",
    "tag_ids": [
      "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"
    ],
    "tags": [
      {
        "id": "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93",
        "name": "Launch",
        "slug": "launch"
      }
    ],
    "template_handle": "default_blog",
    "title": "Launch notes",
    "updated_at": "2026-01-05T12:00:00Z"
  },
  "success": true
}

Delete a blog post

DELETE write_blog

Delete a blog post.

Deletes a Blog Post together with its category/tag assignments and translations.

Path parameters

Name	Type	Description
`id` required	`uuid`	Blog Post id. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`

Headers

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

Errors

400 BLOG_POST_BULK_NO_IDS
No Blog Post ids were provided.
400 BLOG_POST_BULK_DELETE_TOO_MANY
Batch exceeds the Blog Post bulk delete cap.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.

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

import requests

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

Response

200

Sample response

{
  "data": {
    "title": "Launch notes"
  },
  "success": true
}

Bulk delete blog posts

POST write_blog

Delete multiple blog posts.

Deletes multiple Blog Posts in one request. The request is capped by the Blog Post bulk contract.

Headers

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

Body parameters

Name	Type	Description
`post_ids` required	`array<uuid>`	Blog Post ids to delete. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`

Errors

400 BLOG_POST_BULK_NO_IDS
No Blog Post ids were provided.
400 BLOG_POST_BULK_DELETE_TOO_MANY
Batch exceeds the Blog Post bulk delete cap.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.

curl -X POST https://api-store.tringify.com/api/2025-01/blog/posts/bulk-delete \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "post_ids": [
    "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
  ]
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/posts/bulk-delete", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "post_ids": [
      "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    ]
  }),
});
const data = await res.json();

import requests

res = requests.post(
    "https://api-store.tringify.com/api/2025-01/blog/posts/bulk-delete",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "post_ids": ["5ff7d4ea-3250-4a4d-9d26-07f64d917d31"],
    },
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "deleted": 1
  },
  "success": true
}

Bulk update blog post status

POST write_blog

Update status for multiple blog posts.

Sets draft, published, or archived status on all supplied post ids. Schedule posts individually because this endpoint does not accept a publish date.

Headers

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

Body parameters

Name	Type	Description
`post_ids` required	`array<uuid>`	Blog Post ids to update. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`
`status` required	`string`	New post status: draft, published, or archived. Example: `published`

Errors

400 BLOG_POST_AUTHOR_REQUIRED
Author is required.
400 BLOG_POST_TITLE_REQUIRED
Title is empty after normalization.
400 BLOG_POST_TITLE_TOO_LONG
Title exceeds the Blog Post contract max length.
400 BLOG_POST_SLUG_REQUIRED
Slug is empty on update. Blank slug auto-generation is only available on create.
400 BLOG_POST_SLUG_FORMAT
Slug is not valid for Blog Post URLs.
400 BLOG_POST_SLUG_TOO_LONG
Slug exceeds the Blog Post contract max length.
404 BLOG_AUTHOR_NOT_FOUND
Author does not exist in this store.
400 BLOG_POST_CONTENT_TOO_LONG
Content exceeds the Blog Post contract max length.
400 BLOG_POST_EXCERPT_TOO_LONG
Excerpt exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_TITLE_TOO_LONG
SEO title exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_DESCRIPTION_TOO_LONG
SEO description exceeds the Blog Post contract max length.
400 BLOG_POST_STATUS_INVALID
Status is not one of the allowed values.
400 BLOG_POST_PUBLISH_DATE_REQUIRED
Scheduled posts require publish_at.
400 BLOG_POST_CATEGORY_IDS_INVALID
One or more category ids do not exist in this store.
400 BLOG_POST_TAG_IDS_INVALID
One or more tag ids do not exist in this store.
400 TEMPLATE_HANDLE_INVALID
Template handle is not valid for Blog Post templates.
400 TEMPLATE_HANDLE_NOT_FOUND
Template handle does not exist on the store's primary active theme for Blog Post.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.
409 BLOG_POST_SLUG_DUPLICATE
Slug already exists in this store.
400 BLOG_POST_BULK_NO_IDS
No Blog Post ids were provided.
400 BLOG_POST_BULK_UPDATE_TOO_MANY
Batch exceeds the Blog Post bulk update cap.

curl -X POST https://api-store.tringify.com/api/2025-01/blog/posts/bulk-update-status \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "post_ids": [
    "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
  ],
  "status": "published"
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/posts/bulk-update-status", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "post_ids": [
      "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    ],
    "status": "published"
  }),
});
const data = await res.json();

import requests

res = requests.post(
    "https://api-store.tringify.com/api/2025-01/blog/posts/bulk-update-status",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "post_ids": ["5ff7d4ea-3250-4a4d-9d26-07f64d917d31"],
        "status": "published",
    },
)
data = res.json()

Response

200

Sample response

{"success":true,"data":null}

Bulk assign categories

POST write_blog

Assign categories to multiple blog posts.

Adds the supplied categories to each post while keeping existing categories.

Headers

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

Body parameters

Name	Type	Description
`post_ids` required	`array<uuid>`	Blog Post ids to update. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`
`category_ids` required	`array<uuid>`	Category ids to add. Example: `3a588f80-fd8c-4d46-af1b-00a1c4a7f85a`

Errors

400 BLOG_POST_AUTHOR_REQUIRED
Author is required.
400 BLOG_POST_TITLE_REQUIRED
Title is empty after normalization.
400 BLOG_POST_TITLE_TOO_LONG
Title exceeds the Blog Post contract max length.
400 BLOG_POST_SLUG_REQUIRED
Slug is empty on update. Blank slug auto-generation is only available on create.
400 BLOG_POST_SLUG_FORMAT
Slug is not valid for Blog Post URLs.
400 BLOG_POST_SLUG_TOO_LONG
Slug exceeds the Blog Post contract max length.
404 BLOG_AUTHOR_NOT_FOUND
Author does not exist in this store.
400 BLOG_POST_CONTENT_TOO_LONG
Content exceeds the Blog Post contract max length.
400 BLOG_POST_EXCERPT_TOO_LONG
Excerpt exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_TITLE_TOO_LONG
SEO title exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_DESCRIPTION_TOO_LONG
SEO description exceeds the Blog Post contract max length.
400 BLOG_POST_STATUS_INVALID
Status is not one of the allowed values.
400 BLOG_POST_PUBLISH_DATE_REQUIRED
Scheduled posts require publish_at.
400 BLOG_POST_CATEGORY_IDS_INVALID
One or more category ids do not exist in this store.
400 BLOG_POST_TAG_IDS_INVALID
One or more tag ids do not exist in this store.
400 TEMPLATE_HANDLE_INVALID
Template handle is not valid for Blog Post templates.
400 TEMPLATE_HANDLE_NOT_FOUND
Template handle does not exist on the store's primary active theme for Blog Post.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.
409 BLOG_POST_SLUG_DUPLICATE
Slug already exists in this store.
400 BLOG_POST_BULK_NO_IDS
No Blog Post ids were provided.
400 BLOG_POST_BULK_UPDATE_TOO_MANY
Batch exceeds the Blog Post bulk update cap.

curl -X POST https://api-store.tringify.com/api/2025-01/blog/posts/bulk-assign-categories \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "category_ids": [
    "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"
  ],
  "post_ids": [
    "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
  ]
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/posts/bulk-assign-categories", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "category_ids": [
      "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"
    ],
    "post_ids": [
      "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    ]
  }),
});
const data = await res.json();

import requests

res = requests.post(
    "https://api-store.tringify.com/api/2025-01/blog/posts/bulk-assign-categories",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "category_ids": ["3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"],
        "post_ids": ["5ff7d4ea-3250-4a4d-9d26-07f64d917d31"],
    },
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "updated": 1
  },
  "success": true
}

Bulk assign tags

POST write_blog

Assign tags to multiple blog posts.

Adds the supplied tags to each post while keeping existing tags.

Headers

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

Body parameters

Name	Type	Description
`post_ids` required	`array<uuid>`	Blog Post ids to update. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`
`tag_ids` required	`array<uuid>`	Tag ids to add. Example: `6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93`

Errors

400 BLOG_POST_AUTHOR_REQUIRED
Author is required.
400 BLOG_POST_TITLE_REQUIRED
Title is empty after normalization.
400 BLOG_POST_TITLE_TOO_LONG
Title exceeds the Blog Post contract max length.
400 BLOG_POST_SLUG_REQUIRED
Slug is empty on update. Blank slug auto-generation is only available on create.
400 BLOG_POST_SLUG_FORMAT
Slug is not valid for Blog Post URLs.
400 BLOG_POST_SLUG_TOO_LONG
Slug exceeds the Blog Post contract max length.
404 BLOG_AUTHOR_NOT_FOUND
Author does not exist in this store.
400 BLOG_POST_CONTENT_TOO_LONG
Content exceeds the Blog Post contract max length.
400 BLOG_POST_EXCERPT_TOO_LONG
Excerpt exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_TITLE_TOO_LONG
SEO title exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_DESCRIPTION_TOO_LONG
SEO description exceeds the Blog Post contract max length.
400 BLOG_POST_STATUS_INVALID
Status is not one of the allowed values.
400 BLOG_POST_PUBLISH_DATE_REQUIRED
Scheduled posts require publish_at.
400 BLOG_POST_CATEGORY_IDS_INVALID
One or more category ids do not exist in this store.
400 BLOG_POST_TAG_IDS_INVALID
One or more tag ids do not exist in this store.
400 TEMPLATE_HANDLE_INVALID
Template handle is not valid for Blog Post templates.
400 TEMPLATE_HANDLE_NOT_FOUND
Template handle does not exist on the store's primary active theme for Blog Post.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.
409 BLOG_POST_SLUG_DUPLICATE
Slug already exists in this store.
400 BLOG_POST_BULK_NO_IDS
No Blog Post ids were provided.
400 BLOG_POST_BULK_UPDATE_TOO_MANY
Batch exceeds the Blog Post bulk update cap.

curl -X POST https://api-store.tringify.com/api/2025-01/blog/posts/bulk-assign-tags \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "post_ids": [
    "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
  ],
  "tag_ids": [
    "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"
  ]
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/posts/bulk-assign-tags", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "post_ids": [
      "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    ],
    "tag_ids": [
      "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"
    ]
  }),
});
const data = await res.json();

import requests

res = requests.post(
    "https://api-store.tringify.com/api/2025-01/blog/posts/bulk-assign-tags",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "post_ids": ["5ff7d4ea-3250-4a4d-9d26-07f64d917d31"],
        "tag_ids": ["6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"],
    },
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "updated": 1
  },
  "success": true
}

Bulk remove categories

POST write_blog

Remove categories from multiple blog posts.

Removes the supplied categories from each post while keeping every other category assignment.

Headers

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

Body parameters

Name	Type	Description
`post_ids` required	`array<uuid>`	Blog Post ids to update. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`
`category_ids` required	`array<uuid>`	Category ids to remove. Example: `3a588f80-fd8c-4d46-af1b-00a1c4a7f85a`

Errors

400 BLOG_POST_AUTHOR_REQUIRED
Author is required.
400 BLOG_POST_TITLE_REQUIRED
Title is empty after normalization.
400 BLOG_POST_TITLE_TOO_LONG
Title exceeds the Blog Post contract max length.
400 BLOG_POST_SLUG_REQUIRED
Slug is empty on update. Blank slug auto-generation is only available on create.
400 BLOG_POST_SLUG_FORMAT
Slug is not valid for Blog Post URLs.
400 BLOG_POST_SLUG_TOO_LONG
Slug exceeds the Blog Post contract max length.
404 BLOG_AUTHOR_NOT_FOUND
Author does not exist in this store.
400 BLOG_POST_CONTENT_TOO_LONG
Content exceeds the Blog Post contract max length.
400 BLOG_POST_EXCERPT_TOO_LONG
Excerpt exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_TITLE_TOO_LONG
SEO title exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_DESCRIPTION_TOO_LONG
SEO description exceeds the Blog Post contract max length.
400 BLOG_POST_STATUS_INVALID
Status is not one of the allowed values.
400 BLOG_POST_PUBLISH_DATE_REQUIRED
Scheduled posts require publish_at.
400 BLOG_POST_CATEGORY_IDS_INVALID
One or more category ids do not exist in this store.
400 BLOG_POST_TAG_IDS_INVALID
One or more tag ids do not exist in this store.
400 TEMPLATE_HANDLE_INVALID
Template handle is not valid for Blog Post templates.
400 TEMPLATE_HANDLE_NOT_FOUND
Template handle does not exist on the store's primary active theme for Blog Post.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.
409 BLOG_POST_SLUG_DUPLICATE
Slug already exists in this store.
400 BLOG_POST_BULK_NO_IDS
No Blog Post ids were provided.
400 BLOG_POST_BULK_UPDATE_TOO_MANY
Batch exceeds the Blog Post bulk update cap.

curl -X POST https://api-store.tringify.com/api/2025-01/blog/posts/bulk-remove-categories \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "category_ids": [
    "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"
  ],
  "post_ids": [
    "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
  ]
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/posts/bulk-remove-categories", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "category_ids": [
      "3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"
    ],
    "post_ids": [
      "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    ]
  }),
});
const data = await res.json();

import requests

res = requests.post(
    "https://api-store.tringify.com/api/2025-01/blog/posts/bulk-remove-categories",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "category_ids": ["3a588f80-fd8c-4d46-af1b-00a1c4a7f85a"],
        "post_ids": ["5ff7d4ea-3250-4a4d-9d26-07f64d917d31"],
    },
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "updated": 1
  },
  "success": true
}

Bulk remove tags

POST write_blog

Remove tags from multiple blog posts.

Removes the supplied tags from each post while keeping every other tag assignment.

Headers

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

Body parameters

Name	Type	Description
`post_ids` required	`array<uuid>`	Blog Post ids to update. Example: `5ff7d4ea-3250-4a4d-9d26-07f64d917d31`
`tag_ids` required	`array<uuid>`	Tag ids to remove. Example: `6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93`

Errors

400 BLOG_POST_AUTHOR_REQUIRED
Author is required.
400 BLOG_POST_TITLE_REQUIRED
Title is empty after normalization.
400 BLOG_POST_TITLE_TOO_LONG
Title exceeds the Blog Post contract max length.
400 BLOG_POST_SLUG_REQUIRED
Slug is empty on update. Blank slug auto-generation is only available on create.
400 BLOG_POST_SLUG_FORMAT
Slug is not valid for Blog Post URLs.
400 BLOG_POST_SLUG_TOO_LONG
Slug exceeds the Blog Post contract max length.
404 BLOG_AUTHOR_NOT_FOUND
Author does not exist in this store.
400 BLOG_POST_CONTENT_TOO_LONG
Content exceeds the Blog Post contract max length.
400 BLOG_POST_EXCERPT_TOO_LONG
Excerpt exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_TITLE_TOO_LONG
SEO title exceeds the Blog Post contract max length.
400 BLOG_POST_SEO_DESCRIPTION_TOO_LONG
SEO description exceeds the Blog Post contract max length.
400 BLOG_POST_STATUS_INVALID
Status is not one of the allowed values.
400 BLOG_POST_PUBLISH_DATE_REQUIRED
Scheduled posts require publish_at.
400 BLOG_POST_CATEGORY_IDS_INVALID
One or more category ids do not exist in this store.
400 BLOG_POST_TAG_IDS_INVALID
One or more tag ids do not exist in this store.
400 TEMPLATE_HANDLE_INVALID
Template handle is not valid for Blog Post templates.
400 TEMPLATE_HANDLE_NOT_FOUND
Template handle does not exist on the store's primary active theme for Blog Post.
404 BLOG_POST_NOT_FOUND
Blog Post does not exist in this store.
409 BLOG_POST_SLUG_DUPLICATE
Slug already exists in this store.
400 BLOG_POST_BULK_NO_IDS
No Blog Post ids were provided.
400 BLOG_POST_BULK_UPDATE_TOO_MANY
Batch exceeds the Blog Post bulk update cap.

curl -X POST https://api-store.tringify.com/api/2025-01/blog/posts/bulk-remove-tags \
  -H "Authorization: Bearer YOUR_STORE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "post_ids": [
    "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
  ],
  "tag_ids": [
    "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"
  ]
}'

const res = await fetch("https://api-store.tringify.com/api/2025-01/blog/posts/bulk-remove-tags", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_STORE_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "post_ids": [
      "5ff7d4ea-3250-4a4d-9d26-07f64d917d31"
    ],
    "tag_ids": [
      "6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"
    ]
  }),
});
const data = await res.json();

import requests

res = requests.post(
    "https://api-store.tringify.com/api/2025-01/blog/posts/bulk-remove-tags",
    headers={"Authorization": "Bearer YOUR_STORE_API_TOKEN"},
    json={
        "post_ids": ["5ff7d4ea-3250-4a4d-9d26-07f64d917d31"],
        "tag_ids": ["6e8b7dd1-7ad5-453d-8a87-67daf4ca9f93"],
    },
)
data = res.json()

Response

200

Sample response

{
  "data": {
    "updated": 1
  },
  "success": true
}

Field	Kind	Create	Update	Required	Translatable
`title`	text	Yes	Yes	create	Yes
`slug`	slug	Yes	Yes		Yes
`content`	rich_text	Yes	Yes		Yes
`excerpt`	textarea	Yes	Yes		Yes
`featured_image_id`	image	Yes	Yes		No
`author_ref`	id	Yes	Yes	create	No
`author`	text	No	No		No
`seo_title`	text	Yes	Yes		Yes
`seo_description`	textarea	Yes	Yes		Yes
`status`	select	Yes	Yes	create	No
`publish_at`	datetime	Yes	Yes		No
`published_at`	datetime	No	No		No
`template_handle`	template	Yes	Yes		No
`category_ids`	id_list	Yes	Yes		No
`tag_ids`	id_list	Yes	Yes		No
`category_count`	integer	No	No		No
`comment_count`	integer	No	No		No
`created_at`	datetime	No	No		No
`updated_at`	datetime	No	No		No
`storefront_url`	url	No	No	No	No

Blog post created

EVENT blog_posts/create write_blog blog:write

Fired when a blog post is created.

Payload fields

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

Payload shape

Sample payload

{
  "blog_post": {
    "author": {
      "avatar_url": "...",
      "bio": "...",
      "created_at": "2026-06-09T12:00:00Z",
      "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
      "name": "Company News",
      "slug": "launch-notes"
    },
    "author_ref": "usr_a1b2c3d4",
    "categories": [
      {
        "created_at": "2026-06-09T12:00:00Z",
        "description": null,
        "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
        "name": "Company News",
        "post_count": 8,
        "seo_description": "Read the latest launch notes.",
        "seo_title": "Launch Notes",
        "slug": "launch-notes",
        "template_handle": "default_blog",
        "updated_at": "2026-06-09T12:00:00Z"
      }
    ],
    "comment_count": 3,
    "content": "\u003cp\u003eWhat changed in this release.\u003c/p\u003e",
    "created_at": "2026-06-09T12:00:00Z",
    "excerpt": "What changed in this release.",
    "featured_image_cdn_url": "",
    "featured_image_id": "f_8f2a1c2b9d4e",
    "featured_image_url": "",
    "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "publish_at": "2026-06-09T12:00:00Z",
    "published_at": "2026-06-09T12:00:00Z",
    "seo_description": "Read the latest launch notes.",
    "seo_title": "Launch Notes",
    "slug": "launch-notes",
    "status": "published",
    "tags": [
      {
        "created_at": "2026-06-09T12:00:00Z",
        "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
        "name": "Company News",
        "post_count": 8,
        "slug": "launch-notes"
      }
    ],
    "template_handle": "default_blog",
    "title": "Launch Notes",
    "updated_at": "2026-06-09T12:00:00Z"
  }
}

Blog post updated

EVENT blog_posts/update write_blog blog:write

Fired when a blog post is updated.

Payload fields

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

Payload shape

Sample payload

{
  "blog_post": {
    "author": {
      "avatar_url": "...",
      "bio": "...",
      "created_at": "2026-06-09T12:00:00Z",
      "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
      "name": "Company News",
      "slug": "launch-notes"
    },
    "author_ref": "usr_a1b2c3d4",
    "categories": [
      {
        "created_at": "2026-06-09T12:00:00Z",
        "description": null,
        "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
        "name": "Company News",
        "post_count": 8,
        "seo_description": "Read the latest launch notes.",
        "seo_title": "Launch Notes",
        "slug": "launch-notes",
        "template_handle": "default_blog",
        "updated_at": "2026-06-09T12:00:00Z"
      }
    ],
    "comment_count": 3,
    "content": "\u003cp\u003eWhat changed in this release.\u003c/p\u003e",
    "created_at": "2026-06-09T12:00:00Z",
    "excerpt": "What changed in this release.",
    "featured_image_cdn_url": "",
    "featured_image_id": "f_8f2a1c2b9d4e",
    "featured_image_url": "",
    "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "publish_at": "2026-06-09T12:00:00Z",
    "published_at": "2026-06-09T12:00:00Z",
    "seo_description": "Read the latest launch notes.",
    "seo_title": "Launch Notes",
    "slug": "launch-notes",
    "status": "published",
    "tags": [
      {
        "created_at": "2026-06-09T12:00:00Z",
        "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
        "name": "Company News",
        "post_count": 8,
        "slug": "launch-notes"
      }
    ],
    "template_handle": "default_blog",
    "title": "Launch Notes",
    "updated_at": "2026-06-09T12:00:00Z"
  }
}

Blog post deleted

EVENT blog_posts/delete write_blog blog:write

Fired when a blog post is deleted.

Payload fields

Field	Type	Description
`blog_post.id`	`string`	Always present
`blog_post.title`	`string`	Can be removed/added via the Payload builder
`blog_post.slug`	`string`	Can be removed/added via the Payload builder

Payload shape

Sample payload

{
  "blog_post": {
    "id": "5ff7d4ea-3250-4a4d-9d26-07f64d917d31",
    "slug": "launch-notes",
    "title": "Launch Notes"
  }
}

Blog settings updated

EVENT blog_settings/update write_blog blog:write

Fired when blog comment settings change.

Payload fields

Field	Type	Description
`settings.comments_mode`	`string`	Always present
`settings.comments_moderation`	`boolean`	Can be removed/added via the Payload builder
`settings.updated_at`	`string`	Always present

Payload shape

Sample payload

{
  "settings": {
    "comments_mode": "...",
    "comments_moderation": false,
    "updated_at": "2026-06-09T12:00:00Z"
  }
}

Endpoints#

Headers

Query parameters

Headers

Errors

Query parameters

Headers

Path parameters

Headers

Errors

Headers

Body parameters

Errors

Path parameters

Headers

Body parameters

Errors

Path parameters

Headers

Errors

Headers

Body parameters

Errors

Headers

Body parameters

Errors

Headers

Body parameters

Errors

Headers

Body parameters

Errors

Headers

Body parameters

Errors

Headers

Body parameters

Errors

Fields#

Webhook events#

Payload fields

Payload fields

Payload fields

Payload fields