Notebooks & datasets
Notebooks & datasets
Hosted marimo notebooks run free in the browser (Pyodide) or on per-minute cloud machines that stop when idle. Datasets accept csv, json, jsonl (agent traces auto-detected), parquet, sqlite .db files, images, and browser-playable video; binary formats stream from the CDN and table previews open in the Sheets editor. Machine rates include the platform margin — what /api/notebooks/pricing returns is what you pay.
basehttps://app.nz
GET
/api/notebooksList your notebooks plus public examplesAPI keyPOST/api/notebooksCreate a notebook ({name, source?, forkOf?})API keyGET/api/notebooks/{slug}Fetch a notebook with its marimo sourceAPI keyPUT/api/notebooks/{slug}Update name, source, visibility, runtimeAPI keyDELETE/api/notebooks/{slug}Delete a notebook (stops its sessions)API keyGET/api/notebooks/{slug}/sessionsList cloud sessions with status and endpointAPI keyPOST/api/notebooks/{slug}/sessionsStart a cloud session ({machineType}), billed per minuteAPI keyDELETE/api/notebooks/sessions/{id}Stop a session and settle billingAPI keyGET/api/notebooks/pricingMachine catalogue with hourly/credit rates and storage pricingpublicPOST/api/datasets/uploadUpload a table, database, image, or video datasetAPI keyGET/api/datasets/u/{id}/notebookGenerated marimo starter notebook for a datasetAPI keyCreate a notebook and run it on a GPU
curl -sX POST https://app.nz/api/notebooks \
-H "Authorization: Bearer pk_live_..." \
-H "Content-Type: application/json" \
-d '{"name":"fraud analysis"}'
curl -sX POST https://app.nz/api/notebooks/nb-1a2b3c4d/sessions \
-H "Authorization: Bearer pk_live_..." \
-d '{"machineType":"gpu-rtx3090"}'
# -> {"session":{"id":"...","status":"provisioning","priceHourly":"$0.264"}}