Self-Hosted HTTP API

The self-hosted engine exposes /api/* on your deployment. It uses that deployment’s account tokens, rather than Cloud mb_live_* keys. The example below uses the local Docker demo and its published demo sign-in code. For the complete route and request schema, open http://localhost:18060/docs while the server is running.

First local API request

Start the Docker demo, then use a second terminal. The example runs against your own machine at http://localhost:18060.

Get a demo account token

Exchange the demo email and code for an access token:

curl -sS http://localhost:18060/email/verify \
  -H "Content-Type: application/json" \
  -d '{"email":"you@mirobody.ai","code":"111111"}'

Copy data.access_token from the response into your shell:

export mirobody_demo_token="<data.access_token>"

Write one reading

Send a structured record to the account represented by the token:

curl -sS http://localhost:18060/api/data \
  -H "Authorization: Bearer $mirobody_demo_token" \
  -H "Content-Type: application/json" \
  -d '{"records":[{"indicator":"fasting_glucose","value":97,"unit":"mg/dL","time":"2026-09-28T07:30:00Z"}]}'

A successful response includes "status":"ok" and "ingested":1. Check standardized to see whether the reading received a code.

Read the account records

curl -sS "http://localhost:18060/api/data?limit=10" \
  -H "Authorization: Bearer $mirobody_demo_token"

The response has "object":"list" and a data array. Find the new reading by its indicator, value, and time. The demo also contains seeded readings.

Cloud and local requests

The local POST /api/data accepts a records array and returns coding information, but it authenticates with a deployment account token. Cloud uses /v1/data, an mb_live_* key, a user Subject key, and a retention setting. On a self-hosted deployment, records belong to the signed-in account; user and retention do not control tenancy or expiry. See the Cloud quickstart for that contract. The demo code is for a local example. Before accepting real records, follow Deploy on a Server to remove demo accounts and codes.

​First local API request

​Cloud and local requests

First local API request

Cloud and local requests