---
name: "help_center_preview"
area: "helpcenter"
title: "Preview the draft"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/help_center_preview"
mcp_server: "https://api.conecto.chat/mcp/helpcenter"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/helpcenter/help_center_preview"
---

# Preview the draft (`help_center_preview`)

A private link to any page of the draft, and the page's HTML if you ask for it.

A private link to any page of the DRAFT (works before the help center is public, never indexed), and the page’s HTML if you ask for it, so you can check your work.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

After a change, to check the page before publishing.

## Say this to your agent

> Let me see the new repair times article before it goes live.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `page` | string | no |  | `"home"`, `"collection"`, `"article"`, `"search"` | `"home"` |
| `collection` | integer | no | For page "collection". |  |  |
| `article` | integer or string | no | Article id or slug, for page "article". |  |  |
| `query` | string | no | For page "search". |  |  |
| `html` | boolean | no |  |  | `false` |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `help_center_preview` on the MCP server `https://api.conecto.chat/mcp/helpcenter` with these arguments:

```json
{
  "page": "article",
  "article": "repair-times"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/help_center_preview \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page": "article", "article": "repair-times"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "help_center_preview",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "url": "https://conecto.chat/help/halverson-cycle-repair/repair-times/?preview=eyJ3IjoxfQ:1xHLr9:t9SGxoL56kn0HOKb7xYys9VKYy1yJkqWzo6EZQY4L8g"
  }
}
```

`result`: url: a private preview link to the page, and its HTML when html is true.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `tool_error` | 422 | No collection or article has that id or slug. | Use ids from help_center_list_collections or help_center_list_articles. |

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_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.
- [help_center_review_suggestion](https://conecto.chat/tools/helpcenter/help_center_review_suggestion.md): Publishes a suggested article or edit, keeps it as a draft, or dismisses it. $0.001 a call.