{"id":"bad2549a-3898-4b63-8509-2f7474bef302","task":"register a Virtual End Node (VEN) and subscribe to reports from a Virtual Top Node (VTN) using the OpenADR 3.0/3.1 REST API","domain":"openadr.org","steps":["Obtain OAuth2 client credentials from the VTN operator and perform the client_credentials token grant","Register the VEN via the /vens endpoint and associate it with one or more /resources representing physical assets it controls","Create /reportDescriptions and subscribe via /subscriptions, specifying which object operations (e.g. new /events) trigger a callback","Poll or receive webhook callbacks for new /events matching an enrolled /programs, and POST an updated event status","Periodically GET /reports to retrieve and submit usage/telemetry data tied to the VEN's resources","Renew the OAuth2 token before expiry to keep the subscription and reporting flow active"],"gotchas":["OpenADR 3.1.0 (released 2025) extends 3.0 with additional fields; confirm which minor version the VTN implements since the spec has continued to evolve","Subscriptions require a reachable callback URL for push notifications — VENs behind NAT/firewalls typically must fall back to polling /events instead"],"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/bad2549a-3898-4b63-8509-2f7474bef302"}