Sharing & Embeds

Sharing is off by default. Turning it on mints a random share id — an unguessable UUID that acts as the public, read-only key to that bot’s numbers. Everything on this page is addressed by that id, so nothing is exposed until you opt in.

Enable it from the bot’s Settings → Sharing page, or via the API:

curl -X POST -H "Content-Type: application/json" \
  -d '{"enabled": true}' \
  --cookie "$SESSION" \
  https://mochi.example.com/api/bots/$BOT_ID/share

{ "shareId": "0f9c4c2e-6a1b-4a0e-9f4b-2d8c1e7a55b1" }

Disabling sets shareId to null.

Public dashboard

https://mochi.example.com/share/{shareId}

A read-only version of the bot’s overview: server count, command volume, unique users, error rate, and the growth charts. No account needed, nothing editable, no raw user ids (Mochi never stores them).

On Mochi Cloud the same page can also be served from your own subdomain — see Custom Domains.

Badges

GET /api/badge/{shareId}

An SVG stat badge for a README or website. Responses are cached for 5 minutes.

servers is the current count and ignores range; the rest are range aggregates and say so in the label (commands (7d)). uptime renders n/a when there are no health snapshots in the range. An unrecognized metric falls back to servers.

![Servers](https://mochi.example.com/api/badge/0f9c4c2e-…)
![Commands](https://mochi.example.com/api/badge/0f9c4c2e-…?metric=commands&range=7d)

Wrap a badge in a link to make it clickable — the settings page hands you this form so a reader can jump from your README to the full public dashboard:

[![Servers](https://mochi.example.com/api/badge/0f9c4c2e-…)](https://mochi.example.com/share/0f9c4c2e-…)

shields.io

?format=shields returns a shields.io endpoint badge  JSON payload instead of SVG, so you can restyle it with shields’ own flags:

![Servers](https://img.shields.io/endpoint?url=https://mochi.example.com/api/badge/0f9c4c2e-…%3Fmetric%3Dservers&style=flat-square)

Remember to URL-encode the query string of the inner URL (? → %3F, & → %26).

Embeddable widget

https://mochi.example.com/share/{shareId}/widget

A compact stat card (~640×130) showing servers, commands, unique users, and error rate — designed to be dropped into an iframe on a bot-list page.

<iframe
  src="https://mochi.example.com/share/0f9c4c2e-…/widget?range=7d&theme=dark"
  width="640" height="130" frameborder="0" loading="lazy"
></iframe>

The bot name links to the full public dashboard; the “stats by Mochi” attribution links to the Mochi project.