Update the existing KB article when correcting a procedure, refreshing a link or improving its wording. A read-before-write workflow preserves the page’s identity and reduces the chance of overwriting somebody else’s work.

Read the current article first

Use a dedicated content connection with a Write ceiling, the required content area and staff permissions. The separate read-only override must permit the intended write. The company needs an active Support Manager plugin, and the bound active staff member’s group needs its Knowledge Base permission. A connection limited to selected clients cannot operate on the shared knowledge base.

Ask the assistant to Read a knowledge base article using the exact article ID. Confirm the title, full body, categories, access and available language versions. A short search excerpt is not enough to prepare a complete body replacement.

Agree the specific change and keep the current content available for comparison. If another editor has changed the article since the review, reconcile those edits rather than applying the earlier replacement blindly.

Submit only the intended changes

The update tool can change title, body, content format, access or category selection. It updates the language you name; omitting the language uses the connection’s default language context. Read the article’s language entries before deciding which text to replace.

Supplying category_ids sets the complete intended category selection, so include every category the article should retain. Access belongs to the article rather than one language entry. Do not include an access change in a translation-only revision unless you intend to change the article’s audience.

1. Confirm the existing article ID and target language.
2. Review the finished replacement text or the specific metadata changes.
3. Authorise Edit a knowledge base article with only the fields that should change.
4. Review a pending approval if the connection requires one.
5. Read the same article back and compare it with the agreed result.

A body edit sends the complete replacement body; describing a paragraph to change does not by itself establish what the tool will save. Ask the assistant to preserve the remaining text and show the intended result before the write.

Verify content and audience

Check that earlier links, headings and any user edits remain unless their removal was intended. Confirm categories and visibility separately from text. Then inspect the native article page as the intended reader.

If the request returns an error or an uncertain result, read the article again before retrying. Do not use Delete and Add as an update shortcut: deletion is a different operation with broader consequences, and recreating content does not preserve the article’s identity.

See the PD MCP Hub Blesta guide for related tasks, or explore PD MCP Hub.