API quickstart

Generate a key, list your screens, push a content update — three calls.

Updated May 18, 2026·5 min read

Step 1 — Create an API key

Dashboard → Settings → API → New key. Pick a role (a key with Viewer role can only read). Copy the key once — we hash it on save and cannot show it again.

Treat keys like passwords

Anyone with a Bearer token can act as the workspace. Store keys in your secrets manager, never in git.

Step 2 — Your first call

List screens to confirm the key works.

Shell

curl https://api.menupi.com/v1/screens \
  -H "Authorization: Bearer mpi_live_••••••"

A successful response

JSON

{
  "data": [
    {
      "id": "scr_01H9K3V5...",
      "name": "Drive-thru #1",
      "location": "loc_5J9Q...",
      "playlist": "pl_8XR4...",
      "status": "online",
      "lastSeen": "2026-05-18T14:29:32Z"
    }
  ],
  "pagination": { "cursor": null, "hasMore": false }
}

Step 3 — Push a content update

Update a price across every screen tied to a playlist.

Shell

curl -X PATCH https://api.menupi.com/v1/content/items/itm_4HG8... \
  -H "Authorization: Bearer mpi_live_••••••" \
  -H "Content-Type: application/json" \
  -d '{ "price": 9.99 }'