Icons
The launcher's icon: one of ours, the character's face, or your own logo as an SVG, PNG or WebP.
The pill, icon and tab launchers show an icon. It's one of ours, the character's face, or your own file. You choose it in the deployment's appearance, as launcher.icon.
Ours
Seven icons, drawn in one style (24 × 24 outlines, stroked in the launcher's colour, balanced for a round button):
chat (the default), wave, sparkle, headset, question, mic and play.
{ "kind": "builtin", "name": "headset", "tint": "#1f5553" }tint is optional (#rrggbb); it defaults to the text colour on the accent. Our icons follow the theme.
The character's face
{ "kind": "face" }The character's face takes the icon's place.
Your own
Upload your logo once, then use its id:
{ "kind": "upload", "id": "ico_…", "mask": "round" }mask is none (the default), round or rounded. The file is always fitted whole, then cut by its mask. Another organization's icon, or a deleted one, is 400 invalid_field. Left out entirely, the launcher shows our chat icon.
Upload one
/v1/widget-iconsmultipart/form-data with one field, file. Answers 201:
{ "id": "ico_…", "kind": "svg", "width": 24, "height": 24, "size_bytes": 812,
"url": "https://talk.madein10.com/api/widget/icons/ico_…", "created_unix": 1793300000 }curl https://talk.madein10.com/v1/widget-icons \
-H "Authorization: Bearer $SECRET_KEY" \
-F "file=@logo.svg"List and delete
/v1/widget-iconsAnswers { "data": [ … ] }, newest first.
/v1/widget-icons/{id}Answers { "id": "ico_…", "deleted": true }. While a live deployment's launcher shows the icon, it's 409 icon_in_use: change the launcher first.
What's accepted
- SVG, PNG or WebP, told apart by the file's bytes, never its name.
- At most 64 KB (413
file_too_large). A PNG or WebP at most 512 × 512. An SVG needs aviewBox(or a width and a height). - Anything else is 400
unsupported_file.
An SVG is rebuilt, never kept as sent
We parse your SVG and write it again from a whitelist of shapes: svg, g, path, rect, circle, ellipse, line, polyline, polygon, defs, linearGradient, radialGradient, stop, clipPath, mask, use and symbol, with their geometry and presentation attributes (the style attribute included).
Dropped: every other element and everything in it (<script>, <foreignObject>, <style>, <image>, <a>, animations, text…), every event handler, links to anything but an internal #id, url() to anything but an #id, data: and javascript: values, @import, CSS escapes, comments and processing instructions. A DOCTYPE is refused, and so is nesting deeper than 64 or more than 4,000 elements.
If your logo uses text, convert the text to outlines before you upload it.
How it's served
Each icon is served at its url, by id, to any site:
- with its image type,
X-Content-Type-Options: nosniffand aContent-Security-Policyofdefault-src 'none'; style-src 'unsafe-inline'; - with
Cross-Origin-Resource-Policy: cross-origin; - cached for a year (
immutable): an icon never changes, and a new one gets a new id. A deleted one is 404.
The widget shows your file only in an <img> (a browser runs nothing in an image), and only for a launcher style that shows an icon. A site with a Content-Security-Policy needs our address in img-src (Security).