Joomla Content (JoomReem) icon

Joomla Content (JoomReem)

Manage Joomla CMS content - by Mohamed Abdelaziz (JoomReem)

Article → Update

AI-generated

Summary

Update an existing Joomla article by ID via a PATCH to /content/articles/{id}, changing only the fields you supply, with optional tag, image and custom-field changes.

Inputs

  • articleId (required) — ID of the article to update.
  • updateFields — Collection of fields to change: alias, associations (JSON of language code to article ID), catid, created_by, featured, articletext, introtext, language, metadesc, metakey, modified_by, state (Published 1, Unpublished 0, Archived 2, Trashed -2), title. Empty strings, null and undefined values are dropped and not sent. Associations are parsed from JSON, and the raw string is sent if parsing fails.
  • updateTags — Tag mode and tag selection. Replace All sends the selected tags as the full list. Clear All sends an empty list. Add and Remove first GET the article to read its current tag IDs, then merge (deduplicated) or subtract the selected tags.
  • updateImages — Intro and full-article image settings. Each image has an action: No Change, Set / Update, or Remove, plus path, alt text and caption. If either action is not skip, the node GETs the article's current images and merges changes into them. Set only overwrites non-empty values. Remove blanks the path, alt and caption.
  • customFields — List of custom field name/value pairs, sent as com_fields. Values containing commas are split into an array, which suits checkboxes and multi-select fields.

Output shape

One item per input item, containing the Joomla API response for the updated article (JSON:API format, typically with data.attributes).

Tag Add/Remove and image changes cost an extra GET request per item. Because empty strings are skipped, you can't clear a text field by leaving it blank. With Continue On Fail enabled, a failed item returns {error: message}.

Examples

Example 1: Publish an article and set its SEO description

Article ID from an earlier node; Update Fields: State = Published, Meta Description = text.

Example 2: Add tags without losing existing ones

Article ID; Tags: Mode = Add, select tags.

Example 3: Replace the intro image and remove the full-article image

Images: Intro Action = Set / Update with path and alt text; Full Article Image Action = Remove.

Links

Discussion