Skip to main content
Glama
fruggr

Zendesk MCP Server by Fruggr

Update Help Center Article

update_article
DestructiveIdempotent

Update article metadata only (draft, promoted, labels as label_names, content tags as content_tag_ids, visibility as permission_group_id / user_segment_id, section_id, sort position, etc.) and return the updated article.

Instructions

Update article metadata only (draft, promoted, labels as label_names, content tags as content_tag_ids, visibility as permission_group_id / user_segment_id, section_id, sort position, etc.) and return the updated article. Does NOT update content (title, body) — use update_article_translation for that.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
draftNoSet true to unpublish the article (revert to draft) or false to publish it.
positionNoSort position within the section (manual ordering only; 0 = first/top). New articles default to position 0. To move an article to the END of its section, set this to one more than the highest current position: read the highest position P from list_articles with sort_by="position", sort_order="desc", then set position = P + 1.
promotedNoSet true to promote (feature) the article in its section, or false to unpromote it.
author_idNoUser id of the article author (from search_users).
article_idYesArticle ID — the numeric id of the article to update. Obtain it from list_articles or search_articles.
section_idNoMove the article to this section (numeric id from list_sections).
label_namesNoLabel names for search ranking (use list_labels to see existing labels).
content_tag_idsNoContent tag ids to attach (use list_content_tags to find them).
user_segment_idNoUser segment that controls who can see the article (id from list_user_segments; if that is forbidden because the token is not a Guide admin, reuse the user_segment_id of an existing article from get_article).
permission_group_idNoGuide permission group controlling who can edit (id from list_permission_groups; if that is forbidden because the token is not a Guide admin, reuse the permission_group_id of an existing article from get_article).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv2.24.0
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
  2. Addedv2.15.0
  3. Removedv2.14.0
  4. Changed2 schema fields changedv2.12.1
    • changedInput schema / properties / permission_group_id / description
      Previous value: -"Guide permission group controlling who can edit (id from list_permission_groups)."New value: +"Guide permission group controlling who can edit (id from list_permission_groups; if that is forbidden because the token is not a Guide admin, reuse the permission_group_id of an existing article from get_article)."
    • changedInput schema / properties / user_segment_id / description
      Previous value: -"User segment that controls who can see the article (id from list_user_segments)."New value: +"User segment that controls who can see the article (id from list_user_segments; if that is forbidden because the token is not a Guide admin, reuse the user_segment_id of an existing article from get_article)."
  5. Changed9 schema fields changedv2.6.0
    • addedInput schema / properties / article_id / description
      Added value: +"Article ID — the numeric id of the article to update. Obtain it from list_articles or search_articles."
    • changedInput schema / properties / author_id / description
      Previous value: -"Author user ID"New value: +"User id of the article author (from search_users)."
    • changedInput schema / properties / content_tag_ids / description
      Previous value: -"Content tag IDs"New value: +"Content tag ids to attach (use list_content_tags to find them)."
    • addedInput schema / properties / draft / description
      Added value: +"Set true to unpublish the article (revert to draft) or false to publish it."
    • changedInput schema / properties / label_names / description
      Previous value: -"Label names for search ranking"New value: +"Label names for search ranking (use list_labels to see existing labels)."
    • changedInput schema / properties / permission_group_id / description
      Previous value: -"Permission group ID"New value: +"Guide permission group controlling who can edit (id from list_permission_groups)."
    • addedInput schema / properties / promoted / description
      Added value: +"Set true to promote (feature) the article in its section, or false to unpromote it."
    • addedInput schema / properties / section_id / description
      Added value: +"Move the article to this section (numeric id from list_sections)."
    • changedInput schema / properties / user_segment_id / description
      Previous value: -"User segment ID for visibility"New value: +"User segment that controls who can see the article (id from list_user_segments)."
  6. Changed1 schema field changedv2.3.1
    • addedInput schema / additionalProperties
      Added value: +false
  7. Changed1 schema field changed
    • addedInput schema / properties / position
      Added value: +{
      +  "description": "Sort position within the section (manual ordering only; 0 = first/top). New articles default to position 0. To move an article to the END of its section, set this to one more than the highest current position: read the highest position P from list_articles with sort_by=\"position\", sort_order=\"desc\", then set position = P + 1.",
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
  8. First observedv1.7.0

TDQS

Score is being calculated.