Skip to main content
PUT
/
blogs
/
{id}
Update a blog post
curl --request PUT \
  --url https://api.salesive.com/api/v1/blogs/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Updated Summer Sale Tips",
  "published": false
}
'
{
  "status": 200,
  "success": true,
  "message": "Blog updated successfully",
  "data": {
    "_id": "66c2a1b2c3d4e5f6a7b8c9d0",
    "title": "Updated Summer Sale Tips",
    "slug": "updated-summer-sale-tips",
    "image": "https://cdn.salesive.com/blog/summer.jpg",
    "description": "How to make the most of our summer promotions.",
    "content": "<p>Full HTML content...</p>",
    "tags": [
      "sales",
      "summer"
    ],
    "shop": "66a0d1c2b3a4958677564738",
    "author": {
      "_id": "66a0e1b2c3d4e5f6a7b8c9d0",
      "name": "Jane Merchant",
      "email": "jane@example.com",
      "avatar": "https://cdn.salesive.com/avatars/jane.png"
    },
    "published": false,
    "publishedAt": null,
    "views": 342,
    "createdAt": "2026-06-14T19:00:00.000Z",
    "updatedAt": "2026-06-28T12:30:00.000Z"
  }
}
Updates a blog post; send only the fields to change (at least one required). Changing the title regenerates the slug and toggling published updates publishedAt accordingly. The store is bound to your app token server-side — never send a shop id.

Authorizations

​
Authorization
string
header
required

Installed-app access token (prefix app_), issued by the OAuth install flow. The store is bound to the token server-side — never send a shop id.

Path Parameters

​
id
string
required

The blog post's unique id.

Body

application/json

Fields accepted when updating a blog post. At least one field must be supplied.

​
title
string

New post title (max 200 characters). Regenerates the slug.

Maximum string length: 200
​
content
string

Post body (HTML or rich text).

​
description
string

Short summary/excerpt (max 500 characters).

Maximum string length: 500
​
image
string

Cover image URL.

​
tags
string[]

Array of tag strings.

​
published
boolean

Publish (true) or unpublish (false). Updates publishedAt accordingly.

Response

The updated blog post.

Standard Salesive response envelope. The operation-specific payload is carried in data.

​
status
integer
required

HTTP status code, echoed in the body.

​
success
boolean
required

Whether the request succeeded.

​
message
string
required

Human-readable result message.

​
data
object

A store-scoped blog post with its author populated.