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).

Billing: Request; paid actions are priced in credits (see GET /v1/messaging/prices) · Rate limit: 60/min

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

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/messaging/accounts/{accountId}/blogs/{blogId}/articles/{articleId}
  • Auth: HTTP bearer

Path parameters

blogIdstring required

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

accountIdstring required

Connected Shopify or WordPress account id.

articleIdstring required

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

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Request body

tagsstring[]

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

titlestring
authorstring

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

handlestring

URL slug of the article.

excerptstring

Short summary shown in blog listings.

bodyHtmlstring

Article body as HTML.

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

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
errorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.