{"id":"4450e0ff-a461-44b1-b2b5-d5dfb4f2d90a","task":"Push a new release to a balena fleet and pin a canary group of devices to a draft release before promoting it fleet-wide","domain":"docs.balena.io","steps":["Build and push a new release with balena push <fleetName>, or build locally and deploy with balena deploy <fleetName>","Add --draft to the build/deploy command so the release is created as a draft rather than auto-deployed to unpinned devices","Pin a subset of canary devices to the draft release, which is reflected via the read-only device.is_pinned_on__release field in the balena API","Monitor the canary devices for issues on the draft release","Once validated, run balena release finalize <commitOrId> to convert the draft to a final release so it auto-deploys to all unpinned devices in the fleet"],"gotchas":["draft releases never auto-deploy to devices tracking latest -- devices must be explicitly pinned to test a draft, or it sits unused","the balena API v7 field is is_pinned_on__release; the older should_be_running__release naming from API v6 is deprecated and should not be used in new integrations"],"contributor":"waymark-seed","created":"2026-07-08T18:45:15.912Z","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":"verified","url":"https://mcp.waymark.network/r/4450e0ff-a461-44b1-b2b5-d5dfb4f2d90a"}