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

# Get the design (`help_center_get_design`)

The full design document, the draft or the published one, with the draft revision.

The full design document: the draft (what you are editing) or what is published, with the draft revision.

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

Before changing the design: read the draft and its rev.

## Say this to your agent

> Show me the help center design that is live right now.

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `which` | string | no |  | `"draft"`, `"published"` | `"draft"` |

## Example

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

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

```json
{
  "which": "published"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/help_center_get_design \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"which": "published"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "help_center_get_design",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "design": {
      "v": 1,
      "template": "classic",
      "language": "en",
      "theme": {
        "brand": {
          "name": "",
          "logo": "",
          "logo_dark": "",
          "logo_height": 28,
          "favicon": "",
          "website": "",
          "website_label": ""
        },
        "colors": {
          "accent": "#0e1116",
          "accent_text": "",
          "background": "#ffffff",
          "surface": "#f6f7f9",
          "text": "#0e1116",
          "muted": "#5b6472",
          "border": "#e6e8ec",
          "header_bg": "#0e1116",
          "header_text": "#ffffff"
        },
        "fonts": {
          "heading": "Inter",
          "body": "Inter",
          "heading_weight": "700",
          "size": 16,
          "tracking": "tight"
        },
        "shape": {
          "radius": 14,
          "density": "comfortable",
          "cards": "outline",
          "width": 1120
        },
        "header": {
          "style": "solid",
          "gradient_to": "#1e3a8a",
          "image": "",
          "overlay": 40,
          "sticky": false,
          "search": "inner",
          "nav": []
        },
        "footer": {
          "text": "",
          "links": [],
          "social": []
        },
        "article": {
          "layout": "toc-right",
          "width": "normal",
          "toc": true,
          "breadcrumbs": true,
          "updated": true,
          "author": true,
          "feedback": true,
          "related": true,
          "cover": "wide"
        },
        "collection": {
          "style": "list",
          "excerpts": true,
          "counts": true
        },
        "seo": {
          "title": "",
          "description": "",
          "image": "",
          "noindex": false
        }
      },
      "pages": {
        "home": [
          {
            "id": "s_20d199a4",
            "type": "hero",
            "props": {
              "title": "",
              "subtitle": "",
              "search": true,
              "placeholder": "",
              "align": "center",
              "size": "regular",
              "image": "",
              "suggestions": []
            },
            "style": {
              "bg": "header",
              "bg_color": "#f6f7f9",
              "pad": "l",
              "width": "normal",
              "show": "all",
              "class": ""
            }
          },
          {
            "id": "s_16a59f11",
            "type": "collections",
            "props": {
              "title": "",
              "style": "cards",
              "columns": "3",
              "show": "all",
              "ids": [],
              "icons": true,
              "descriptions": true,
              "counts": true
            },
            "style": {
              "bg": "none",
              "bg_color": "#f6f7f9",
              "pad": "m",
              "width": "normal",
              "show": "all",
              "class": ""
            }
          }
        ],
        "collection": [
          {
            "id": "s_184dd0bc",
            "type": "collection_articles",
            "props": {},
            "style": {
              "bg": "none",
              "bg_color": "#f6f7f9",
              "pad": "m",
              "width": "normal",
              "show": "all",
              "class": ""
            }
          }
        ],
        "article": [
          {
            "id": "s_a7b34277",
            "type": "article_body",
            "props": {},
            "style": {
              "bg": "none",
              "bg_color": "#f6f7f9",
              "pad": "m",
              "width": "normal",
              "show": "all",
              "class": ""
            }
          },
          {
            "id": "s_2718c00d",
            "type": "cta",
            "props": {
              "title": "",
              "text": "",
              "button": "",
              "action": "chat",
              "url": "",
              "email": "",
              "style": "plain"
            },
            "style": {
              "bg": "none",
              "bg_color": "#f6f7f9",
              "pad": "m",
              "width": "normal",
              "show": "all",
              "class": ""
            }
          }
        ],
        "search": [
          {
            "id": "s_5459aa00",
            "type": "search_results",
            "props": {},
            "style": {
              "bg": "none",
              "bg_color": "#f6f7f9",
              "pad": "m",
              "width": "normal",
              "show": "all",
              "class": ""
            }
          }
        ]
      },
      "css": "",
      "labels": {}
    },
    "rev": 0,
    "dirty": false
  }
}
```

`result`: design: the whole design document, rev: the draft revision, and dirty: whether the draft differs from what is published.

## Errors

This tool has no errors of its own.

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_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.
- [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.