Sign in
Blogs

Update a blog article

Partial-updates an article. Send any subset of the create fields (title, bodyHtml, handle, tags, author, excerpt, image, seo, isPublished, publishDate); at least one field is required (an empty body returns 400). isPublished and publishDate behave as on create: isPublished: false unpublishes back to a draft and a future publishDate schedules publication natively on the platform. Omitting both fields preserves the current WordPress status. Omitting image preserves the current featured image; removal is not supported. WordPress rejects seo and does not support SEO-plugin/custom-field, category, or custom-post-type writes.

Supported on Shopify (shopify) and WordPress (wordpress).

patch/v1/accounts/{accountId}/blogs/{blogId}/articles/{articleId}

Path parameters

accountIdstring required

Connected Shopify or WordPress account id.

blogIdstring required

Platform-native numeric blog/site id returned by the list operation.

articleIdstring required

Platform-native numeric article id. Non-numeric values return 400.

Request body

titlestring
bodyHtmlstring

Article body as HTML.

handlestring

URL slug of the article.

tagsstring[]

Replaces the full tag-name list. WordPress resolves existing names case-insensitively and creates missing tags.

authorstring

Shopify author display name, or numeric WordPress user id serialized as a string. Assigning another WordPress user may require elevated capability.

excerptstring

Short summary shown in blog listings.

isPublishedboolean

Set false to move to draft or true to publish. On WordPress false takes priority over a future publishDate; omission preserves status unless publishDate is sent.

publishDatestring date-time

ISO 8601 datetime with offset (or Z). A future date schedules publication natively on the platform.

Response

Article updated

platform'shopify' | 'wordpress'

Changes