Quick Start

Create your account and dashboard

Sign up at easyboard.live. You'll get a dashboard immediately — no credit card, no waiting.

After sign-up, your welcome email contains your write token. Save it — you'll need it to push data. You can also view it anytime from your dashboard settings (the gear icon).

Add a tile to your dashboard

Open your dashboard and click Add tile. For a first test, choose Metric — a large number with an optional unit. Give it a title like "Temperature" and set the unit to °C. Click save.

Find your tile ID

Each tile has a unique ID. The easiest way to find it is to call the tiles API — paste this URL into your browser (swap in your real dashboard ID):

curl https://easyboard.live/api/d/<your-dashboard-id>/tiles

You'll get a JSON array. Each object has an id field — copy the one for the tile you just created.

Push your first value

Now update the tile. Swap in your dashboard ID, tile ID, and write token:

curl -X PATCH https://easyboard.live/api/d/<dashboard-id>/tiles \
  -H "Authorization: Bearer <your-write-token>" \
  -H "Content-Type: application/json" \
  -d '{"updates": [{"target": {"id": "<tile-id>"}, "patch": {"value": "42"}}]}'

import os, requests

DASHBOARD_ID = os.environ["EASYBOARD_DASHBOARD_ID"]
WRITE_TOKEN  = os.environ["EASYBOARD_WRITE_TOKEN"]

def update_tile(tile_id: str, value) -> None:
    requests.patch(
        f"https://easyboard.live/api/d/{DASHBOARD_ID}/tiles",
        headers={"Authorization": f"Bearer {WRITE_TOKEN}"},
        json={"updates": [{"target": {"id": tile_id}, "patch": {"value": str(value)}}]},
        timeout=10,
    )

update_tile("your-tile-id", 42)

Switch back to your dashboard tab — the tile value should have changed instantly. No refresh needed. That's real-time via Server-Sent Events.

Update multiple tiles at once (optional)

If you have several tiles, a batch request updates them all in one API call:

curl -X PATCH https://easyboard.live/api/d/<dashboard-id>/tiles \
  -H "Authorization: Bearer <your-write-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "updates": [
      {"target": {"id": "<tile-id-1>"}, "patch": {"value": "24.3"}},
      {"target": {"id": "<tile-id-2>"}, "patch": {"value": "Online"}}
    ]
  }'

Batch updates are atomic — if any tile fails (wrong ID, for example), none of them are saved.