Skip to content

Edge claim pairing

Prerequisites

Section titled “Prerequisites”
  • Physical or SSH access to Edge appliance
  • Ability to call Cloud internal assign API (CLOUD_INTERNAL_API_TOKEN) — Management Assign UI is not implemented yet
  • Target tenant UUID already exists

Steps

Section titled “Steps”
  1. On appliance, run monozu edge register.
  2. Note the claim code (XXX-XXX) — valid ~24h.
  3. Assign the device to a tenant (staff/automation):
Terminal window
curl -X POST "https://<cloud-api>/internal/devices/assign" \
  -H "Authorization: Bearer $CLOUD_INTERNAL_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"claim_code":"XXX-XXX","tenant_id":"<uuid>","name":"optional","location":"optional"}'
  1. Wait for CLI to reach assigned and finish claim-complete automatically.
  2. Verify agent is online (last_seen_at within 90s).
  3. Customer can edit label/location in Cloud SPA (PATCH /api/v1/edge/devices/{id}).

Resume interrupted pairing

Section titled “Resume interrupted pairing”

Re-run monozu edge register (resumes from /data/edgezu/claim.json). Use --new only to abandon the current claim.

Section titled “Related”