--- name: "help_center_review_suggestion" area: "helpcenter" title: "Decide on a suggestion" price: "$0.001" method: "POST" url: "https://api.conecto.chat/v1/tools/help_center_review_suggestion" mcp_server: "https://api.conecto.chat/mcp/helpcenter" auth: "Authorization: Bearer " docs_url: "https://conecto.chat/tools/helpcenter/help_center_review_suggestion" --- # Decide on a suggestion (`help_center_review_suggestion`) Publishes a suggested article or edit, keeps it as a draft, or dismisses it. Publish a suggested article or edit (optionally with your own title, description or Markdown), save it as an unpublished draft, or dismiss it. A dismissed topic is not proposed again for 90 days. Price: $0.001 a call. A call that fails costs nothing. ## Use it when A suggestion was read and the owner (or the agent) decided on it. ## Say this to your agent > Publish the suggested article about shipping out of state, but call it "Shipping to Washington and California". ## Inputs | Name | Type | Required | Description | Allowed values | Default | |---|---|---|---|---|---| | `id` | integer | yes | | | | | `action` | string | yes | | `"publish"`, `"draft"`, `"dismiss"` | | | `title` | string | no | Up to 255 characters. | | | | `description` | string | no | Up to 300 characters. | | | | `markdown` | string | no | | | | ## Example Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. MCP: call `help_center_review_suggestion` on the MCP server `https://api.conecto.chat/mcp/helpcenter` with these arguments: ```json { "id": 4157, "action": "publish", "title": "Shipping to Washington and California" } ``` REST: ```bash curl https://api.conecto.chat/v1/tools/help_center_review_suggestion \ -H "Authorization: Bearer $CONECTO_KEY" \ -H "Content-Type: application/json" \ -d '{"id": 4157, "action": "publish", "title": "Shipping to Washington and California"}' ``` ## Response ```json { "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93", "tool": "help_center_review_suggestion", "status": "succeeded", "replayed": false, "cost_usd": "$0.001", "balance_usd": "$19.75", "result": { "suggestion": { "id": 4157, "kind": "new", "status": "published", "title": "Shipping to Washington and California", "description": "Costs, times and packing for orders outside Oregon.", "question": "Do you ship bikes to Seattle?", "reason": "The team answered this 4 times in chat this month, and no article covers it.", "confidence": 0.86, "auto": false, "sources": 4, "created_at": "2026-10-12T07:00:00Z", "decided_at": "2026-10-14T08:00:00Z", "category": 4111, "article": { "id": 4344, "title": "Shipping to Washington and California", "slug": "shipping-to-washington-and-california" } }, "article": { "id": 4344, "title": "Shipping to Washington and California", "slug": "shipping-to-washington-and-california", "description": "Costs, times and packing for orders outside Oregon.", "category": 4111, "collection": "Service and shipping", "published": true, "featured": false, "cover": "", "seo_title": "", "seo_description": "", "options": {}, "source": "agent", "views": 0, "helpful_up": 0, "helpful_down": 0, "reviewed_at": null, "created_at": "2026-10-14T08:00:00Z", "updated_at": "2026-10-14T08:00:00Z", "url": "/help/halverson-cycle-repair/shipping-to-washington-and-california/", "excerpt": "We ship built bikes to Washington and California. Shipping takes 3 to 5 working days." } } } ``` `result`: The suggestion with its new status, and the article it published or saved as a draft. ## Errors | Code | Status | When | Fix | |---|---|---|---| | `tool_error` | 422 | No suggestion has that id, or it was decided already. | List the pending ones with help_center_suggestions. | The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md ## Related - [help_center_overview](https://conecto.chat/tools/helpcenter/help_center_overview.md): Where the help center lives and what is in it: its address, whether it is public, unpublished changes, collections and recent articles. Free up to 1,000,000 reads a month. - [help_center_design_guide](https://conecto.chat/tools/helpcenter/help_center_design_guide.md): The whole design language as data: theme fields, section types, templates, fonts, icons, languages, CSS rules and article blocks. Free up to 1,000,000 reads a month. - [help_center_get_design](https://conecto.chat/tools/helpcenter/help_center_get_design.md): The full design document, the draft or the published one, with the draft revision. Free up to 1,000,000 reads a month. - [help_center_update_design](https://conecto.chat/tools/helpcenter/help_center_update_design.md): Changes the draft design: theme, whole pages, CSS, words or language; visitors see nothing until it is published. $0.001 a call. - [help_center_edit_sections](https://conecto.chat/tools/helpcenter/help_center_edit_sections.md): Adds, changes, moves, copies or removes sections on one page of the draft. $0.001 a call. - [help_center_apply_template](https://conecto.chat/tools/helpcenter/help_center_apply_template.md): Starts the draft design over from a built-in template; the brand, language, words and CSS carry over. $0.001 a call. - [help_center_preview](https://conecto.chat/tools/helpcenter/help_center_preview.md): A private link to any page of the draft, and the page's HTML if you ask for it. Free up to 1,000,000 reads a month. - [help_center_publish](https://conecto.chat/tools/helpcenter/help_center_publish.md): Makes the draft design what visitors see; the previous design is kept as a version. $0.01 a call. - [help_center_set_public](https://conecto.chat/tools/helpcenter/help_center_set_public.md): Opens the published help center to everyone, or closes it again. $5 a month while the help center is public, $0.001 to close it ($5.00 a month while public), up to $5.00. - [help_center_list_collections](https://conecto.chat/tools/helpcenter/help_center_list_collections.md): Every collection with its id, icon, description and article count. Free up to 1,000,000 reads a month. - [help_center_save_collection](https://conecto.chat/tools/helpcenter/help_center_save_collection.md): Creates a collection, or changes one: name, description, icon and order. $0.01 a call. - [help_center_delete_collection](https://conecto.chat/tools/helpcenter/help_center_delete_collection.md): Deletes a collection; its articles stay and move to General. $0.001 a call. - [help_center_list_articles](https://conecto.chat/tools/helpcenter/help_center_list_articles.md): Articles, newest change first, matching words, in one collection, or only published or drafts. Free up to 1,000,000 reads a month. - [help_center_get_article](https://conecto.chat/tools/helpcenter/help_center_get_article.md): One article with its HTML content and recent revisions, by id or slug. Free up to 1,000,000 reads a month. - [help_center_save_article](https://conecto.chat/tools/helpcenter/help_center_save_article.md): Creates an article or changes one, written in Markdown or HTML; it stays a draft until published. $0.01 a call. - [help_center_delete_article](https://conecto.chat/tools/helpcenter/help_center_delete_article.md): Deletes an article for good, with its revisions. $0.001 a call. - [help_center_upload_image](https://conecto.chat/tools/helpcenter/help_center_upload_image.md): Stores an image for the design or an article and returns the path to use. $0.01 a call. - [help_center_gaps](https://conecto.chat/tools/helpcenter/help_center_gaps.md): What visitors could not find: searches with no results, and chat questions that ended with a handoff to the team. Free up to 1,000,000 reads a month. - [help_center_suggestions](https://conecto.chat/tools/helpcenter/help_center_suggestions.md): New articles and edits the help center proposes from the team's own answers, waiting for a decision. Free up to 1,000,000 reads a month.