Upload an image
Stores an image for the design or an article and returns the path to use.
$0.01 a call
From your agent’s balance. A call that fails costs nothing.
An example
Here's a photo of the shop floor. Put it in the help center's header.
Your agent callshelp_center_upload_image$0.01 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.
{
"filename": "shop-floor-header.png",
"data": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAICAIAAABLbSncAAAAFUlEQVR42mPUVlFgwAaYGHCAwSkBAFztAH+qHNFaAAAAAElFTkSuQmCC"
}Use it when
A logo, header picture, cover or article image is needed.
What it does
Store an image (logo, header or hero background, article cover, picture for an article) and get the path to use in the design or an article. Give a public https `url`, or the file as base64 `data`. PNG, JPEG, GIF, WebP or SVG, up to 5 MB.
What comes back
url: the stored image's path, to use in the design or an article, with its content_type and size in bytes. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
url | string | Up to 2,000 characters. |
data | string | |
filename | string | Up to 120 characters. |
The call
Over MCP, call help_center_upload_image on https://api.conecto.chat/mcp/helpcenter. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/help_center_upload_image \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"filename":"shop-floor-header.png","data":"iVBORw0KGgoAAAANSUhEUgAAAAgAAAAICAIAAABLbSncAAAAFUlEQVR42mPUVlFgwAaYGHCAwSkBAFztAH+qHNFaAAAAAElFTkSuQmCC"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
tool_error422 | Both or neither of url and data were given, the url is not https or could not be fetched, or the file is not a PNG, JPEG, GIF, WebP or SVG of up to 5 MB. | Send exactly one of url or data, with an image in one of those formats. |
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* - Update the design
help_center_update_designChanges the draft design: theme, whole pages, CSS, words or language; visitors see nothing until it is published.$0.001 a call - 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
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md