Update the design
Changes the draft design: theme, whole pages, CSS, words or language; visitors see nothing until it is published.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
Make the help center use our forest green as the accent colour, with Fraunces for the headings.
Your agent callshelp_center_update_design$0.001 a call
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"theme": {
"colors": {
"accent": "#1f4d3a"
},
"fonts": {
"heading": "Fraunces"
}
}
}Use it when
The help center's look changes: colours, fonts, page layouts, CSS or wording.
- For one section added, moved or removed, use
help_center_edit_sections. - For a fresh start from a built-in look, use
help_center_apply_template.
What it does
Change the DRAFT design: theme fields (groups merge field by field), whole pages (each page’s full ordered list of sections), your CSS (replaces the previous stylesheet), the help center’s words, or its language. Invalid values are left as they were and named in `warnings`. Nothing is live until help_center_publish.
What comes back
rev: the new draft revision, warnings for values left as they were, css_warnings, dirty and a preview link. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
theme | object | e.g. {"colors": {"accent": "#ff5500"}, "fonts": {"heading": "Fraunces"}}. |
pages | object | Page -> full list of sections ({id?, type, props, style}). Keep a section’s id to keep it. For one change, help_center_edit_sections is simpler. |
pages.home | array of objects | |
pages.collection | array of objects | |
pages.article | array of objects | |
pages.search | array of objects | |
css | string | Up to 100,000 characters. |
labels | object | |
language | string | One of: en,pt,es,fr,de,it,nl,sv,no,da,uk,ru,zh. |
rev | integer | The draft revision you last read (from any tool that returns `rev`). If the draft changed since, nothing is saved and you get the current revision to re-read. |
The call
Over MCP, call help_center_update_design on https://api.conecto.chat/mcp/helpcenter. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/help_center_update_design \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"theme":{"colors":{"accent":"#1f4d3a"},"fonts":{"heading":"Fraunces"}}}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
tool_error422 | The draft changed since the rev you sent, or nothing to change was given. | Read the design again with help_center_get_design, then redo the change with its rev. |
More Help center tools
All 20 tools- Help center overview
help_center_overviewWhere the help center lives and what is in it: its address, whether it is public, unpublished changes, collections and recent articles.Free* - Design guide
help_center_design_guideThe whole design language as data: theme fields, section types, templates, fonts, icons, languages, CSS rules and article blocks.Free* - Get the design
help_center_get_designThe full design document, the draft or the published one, with the draft revision.Free* - Edit page sections
help_center_edit_sectionsAdds, changes, moves, copies or removes sections on one page of the draft.$0.001 a call - Apply a template
help_center_apply_templateStarts the draft design over from a built-in template; the brand, language, words and CSS carry over.$0.001 a call - Preview the draft
help_center_previewA private link to any page of the draft, and the page's HTML if you ask for it.Free* - Publish the design
help_center_publishMakes the draft design what visitors see; the previous design is kept as a version.$0.01 a call - Make the help center public
help_center_set_publicOpens the published help center to everyone, or closes it again.$5.00 a month while public
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md