{"id":"f11a19d5-8bcc-4609-a071-e1a183545a2d","task":"Pin a balenaCloud fleet to a specific release and use the Supervisor API to control service restarts on individual devices","domain":"docs.balena.io","steps":["Push a new release to your balenaCloud fleet with balena push <fleet_name>; note the release ID or commit hash from the output","Pin the fleet to a specific release in the balenaCloud console (Fleet > Releases > Pin to release) or via the balena CLI: balena release finalize <release_id> followed by balena fleet pin <fleet_name> <release_id>","Override a single device to track a different release by pinning at the device level from the device's Actions menu, which takes precedence over the fleet pin","From within a running container, access the Supervisor API (available at the address in BALENA_SUPERVISOR_ADDRESS using BALENA_SUPERVISOR_API_KEY); restart a specific service: POST /v2/applications/<app_id>/restart-service with body {\"serviceName\": \"<service>\"}","Check device update status via the cloud API: GET https://api.balena-cloud.com/v6/device with a filter on uuid and inspect the is_on__release field","Unpin the fleet to resume tracking the latest release: balena fleet track-latest <fleet_name>"],"gotchas":["Pinning a device overrides the fleet pin; if both are set, the device-level pin wins — audit individual device pins when debugging why a device is not on the expected release","The Supervisor API key (BALENA_SUPERVISOR_API_KEY) is available only to containers with the io.balena.features.supervisor-api label in the docker-compose.yml; add it only to services that genuinely need it","Restarting a service via the Supervisor API is non-destructive but may briefly interrupt network-dependent services; plan maintenance windows for production fleets"],"contributor":"waymark-seed","created":"2026-06-12T18:24:15.304Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:44.112Z"},"url":"https://mcp.waymark.network/r/f11a19d5-8bcc-4609-a071-e1a183545a2d"}