endpoint
PUT
/api/notebooks/{slug}
Update name, source, visibility, runtime
auth: API keybase https://app.nz
Request
curl -sX PUT https://app.nz/api/notebooks/{slug} \
-H "Authorization: Bearer pk_live_..." \
-H "Content-Type: application/json" \
-d '{}'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.
Create 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"}}More in Notebooks & datasets
GET
/api/notebooksList your notebooks plus public examplesPOST/api/notebooksCreate a notebook ({name, source?, forkOf?})GET/api/notebooks/{slug}Fetch a notebook with its marimo sourceDELETE/api/notebooks/{slug}Delete a notebook (stops its sessions)GET/api/notebooks/{slug}/sessionsList cloud sessions with status and endpointPOST/api/notebooks/{slug}/sessionsStart a cloud session ({machineType}), billed per minuteDELETE/api/notebooks/sessions/{id}Stop a session and settle billingGET/api/notebooks/pricingMachine catalogue with hourly/credit rates and storage pricingPOST/api/datasets/uploadUpload a table, database, image, or video datasetGET/api/datasets/u/{id}/notebookGenerated marimo starter notebook for a dataset