Blogs

Update a blog article

Changed on

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 or Wix 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. On Webflow, an edit to a published item goes live immediately, isPublished: false unpublishes it, and a future publishDate returns 400.

Supported on Shopify (shopify), WordPress (wordpress), Wix (wix) and Webflow (webflow).

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

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/accounts/{accountId}/blogs/{blogId}/articles/{articleId}
  • Auth: HTTP bearer

Path parameters

accountIdstring required

Connected Shopify, WordPress, Wix or Webflow account id.

blogIdstring required

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

articleIdstring required

Platform-native article id: numeric on Shopify and WordPress, a GUID on Wix, a 24-character hex item id on Webflow. Other formats return 400.

Request body

titlestring
bodyHtmlstring

Article body as HTML.

handlestring

URL slug of the article.

tagsstring[]

Replaces the full tag-name list. WordPress and Wix resolve existing names case-insensitively and create missing tags (Wix allows up to 30).

authorstring

Shopify author display name, numeric WordPress user id serialized as a string, or Wix site member id. Assigning another WordPress user may require elevated capability. Wix posts without one go to the site's default author.

excerptstring

Short summary shown in blog listings.

isPublishedboolean

Set false to move to draft or true to publish. On WordPress and Wix false takes priority over a future publishDate; omission preserves status unless publishDate is sent (edits to a published Wix post go live).

publishDatestring date-time

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

fieldDataobject

Webflow only. The collection's own fields that the Blogs API does not map, keyed by field slug, in Webflow's value format (a Reference is an item id, an Image is { url, alt }). Required by collections with required fields of their own; a create that leaves one empty answers 400 listing them. A slug the API already fills (name, slug, body, summary, image, tags, author, date) or one the collection lacks answers 400. Other platforms answer 400.

Response

Article updated

platform'shopify' | 'wordpress' | 'wix' | 'webflow'

Changes

  • 5304778ae6b6Revision changes
    • warning

      added the new webflow enum value to the / response property for the response status

    • warning

      added the new webflow enum value to the response property for the response status

    • info

      added the new optional request property

  • 0d064f3b2f7aRevision changes
    • warning

      changed the pattern of the path request parameter articleId from ^\d+$ to ^[A-Za-z0-9_-]{1,64}$

    • warning

      changed the pattern of the path request parameter blogId from ^\d+$ to ^[A-Za-z0-9_-]{1,64}$

    • warning

      added the new wix enum value to the / response property for the response status

    • warning

      added the new wix enum value to the response property for the response status