troubleshooting · team

The machine id is not a valid UUID

A presence update sent a machine_id the API could not parse as a UUID, so the device's here-now row was refused.

fix

Send a stable opaque UUID minted once per device. The shoti CLI mints one for you; if you call the API directly, generate a v4 UUID and reuse it for the machine's lifetime.

presence-machine-id

Run shoti explain presence-machine-id to read this offline. Still stuck? hello@shoti.ai.

All topics: shoti.ai/troubleshooting.