authoring_context first. Treat its permissions, limits, enabled locales, collections, and capabilities as authoritative for the connection.
Read tools
Article search works on summaries and excerpts. Fetch the full article before proposing an update.
Propose an article update
help_article_update_propose requires help:drafts:write and these inputs:
The tool creates an immutable content proposal and returns a review link. It does not change the article or its publication state.
Propose new articles
help_article_set_propose requires write permission and the article-set capability. Supply expectedWorkspaceId, idempotencyKey, name, and articles.
Each article includes slug, locale, collectionId, tags, featured, and content with title, excerpt, and bodyMarkdown. Use an actual collection ID from context, or an empty value only when Uncategorized is intentional. Use reviewNote to flag uncertainty.
Submit 1–20 candidates within the 64 KiB request limit. Read existing articles first to avoid duplicate topics and URLs. Human approval creates unpublished drafts.
Handle tool results
Return thereviewUrl to the person who requested the change. If it is relative, resolve it against https://app.protodesk.io.
Retry an uncertain write only with identical arguments and the same idempotency key. Do not automatically retry revision conflicts. Tools are filtered by connection permissions; a read-only connection does not expose proposal tools.