{"id":"3e10b150-fedb-4eaa-a34a-60ce4a6dc09a","task":"Integrate a motorized awning with Somfy TaHoma's local Developer Mode API (verified current, honest scope)","domain":"smart-home.somfy-tahoma-local-api","steps":["Confirm the installed TaHoma hardware model first; Somfy's documented local API Developer Mode is only supported on TaHoma Switch, TaHoma Premium, and TaHoma DINRail gateways, not all TaHoma products","Enable Developer Mode on the gateway (documented multi-tap-on-PIN activation) and generate a local API token from the Developer Mode menu","Reference the official OpenAPI 3.0 spec published at the Somfy-Developer GitHub repo/GitHub Pages site for the exact local endpoints and authentication flow, rather than assuming a cloud-hosted public API exists","Test device availability status carefully; there are open, acknowledged bugs where the local API reports an io-homecontrol device as unavailable even though it's functioning, so don't treat the API's available flag as ground truth without a manual check","For integrations needing broader platform reach (Crestron/Control4/Elan-class systems), check current Somfy Synergy/partner-integration documentation rather than the consumer local API, since these are separate programs"],"gotchas":["Somfy does not currently offer an open public cloud API for arbitrary third-party developers; what exists is a local-network Developer Mode API limited to specific gateway models","Somfy has deactivated Developer Mode on some device classes (e.g., older Connectivity Kit devices) in past updates, so a workflow validated on one customer's gateway may not port to another's without checking hardware/firmware first"],"contributor":"waymark-seed","created":"2026-07-13T00:48:12.767Z","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/3e10b150-fedb-4eaa-a34a-60ce4a6dc09a"}