# Recipe: a live dashboard
Publish a dashboard once, then push new numbers to it on a schedule. People who have it open see the numbers change without reloading.
You need a DocPin workspace and either an API key (**Connections → API keys**) or DocPin connected to Claude or ChatGPT.
## 1. The page
A complete page. It reads everything from [page data](/docs/page-data.md), handles missing values, and re-checks every minute.
```html
Sales dashboard
Sales dashboard
Loading…
| Region | Revenue |
|---|
| No regions yet |
```
It uses `textContent`, not `innerHTML`, for data values, so text in the data can't inject markup.
## 2. Publish it
**From the API:**
```bash
curl https://api.docpin.app/v1/pages \
-H "Authorization: Bearer $DOCPIN_API_KEY" \
-F file=@dashboard.html -F slug=sales
```
The response includes `url` (the link to share) and `doc.id`. Save `doc.id` as `PAGE_ID`.
**From Claude or ChatGPT:** "Publish this to DocPin as sales."
## 3. Push numbers
**From the API**, from cron, CI or any scheduler:
```bash
curl -X PATCH https://api.docpin.app/v1/pages/$PAGE_ID/data \
-H "Authorization: Bearer $DOCPIN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"revenue": 128400,
"customers": 37,
"regions": [{"name": "New Zealand", "revenue": 51200}, {"name": "Australia", "revenue": 77200}],
"asOf": "2026-11-06T09:00:00Z"
}'
```
**From Node.js:**
```js
const res = await fetch(`https://api.docpin.app/v1/pages/${process.env.PAGE_ID}/data`, {
method: "PATCH",
headers: { Authorization: `Bearer ${process.env.DOCPIN_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({ revenue: 128400, customers: 37, asOf: new Date().toISOString() }),
});
if (!res.ok) throw new Error((await res.json()).error);
```
**From Python:**
```python
import os, datetime, requests
r = requests.patch(
f"https://api.docpin.app/v1/pages/{os.environ['PAGE_ID']}/data",
headers={"Authorization": f"Bearer {os.environ['DOCPIN_API_KEY']}"},
json={"revenue": 128400, "customers": 37, "asOf": datetime.datetime.now(datetime.timezone.utc).isoformat()},
)
r.raise_for_status()
```
**From Claude or ChatGPT:** "Update the data on the sales dashboard: revenue 128,400, 37 customers." The app calls `set_page_data`.
## 4. Check it
- Open the page's link: the numbers show, and anyone with it open sees updates within a minute.
- In the DocPin app, the page's **Data** tab shows the current JSON.
- `GET /v1/pages/$PAGE_ID/data` returns it too.
## Variations
- **Private dashboard:** make the page password-protected or people-only (Pro). The data is then just as private.
- **Several sources:** have each job `PATCH` only its own keys (`sales`, `support`, `uptime`), so they never overwrite each other.
- **History or charts:** keep a short array in the data, e.g. the last 30 daily values, and replace it each run. Store long history elsewhere: the limit is 1 MB per page.