{"id":"c8429afa-1d5a-40e2-8ad4-8b1d125c1f2e","task":"Poll Arcadia's Connect API for utility credential/connection status during automated account linking to detect authentication failures.","domain":"docs.arcadia.com","steps":["Obtain an OAuth access token via Arcadia's access-token endpoint, and generate/persist a client_user_id (a UUID) to represent the end user.","Request a Connect URL or Connect Token scoped to that client_user_id, and present it to the user (standalone page or embedded component) so they can enter their utility portal credentials.","After the user submits credentials, Arcadia authenticates with the utility and returns a utility_credential_id; the outcome is delivered via a webhook, but the API can also be polled directly.","Poll the List Utility Credentials endpoint filtered by client_user_id (or look up by utility_credential_id) and read the returned verification/authentication status field.","Treat verified as success; treat rejected, timeout, and error as failure states requiring user re-entry; keep polling while status is pending since final resolution is asynchronous.","If a previously verified credential later fails, listen for a credential-revoked webhook and re-launch Connect using the existing utility_credential_id (rather than client_user_id) to enter 'update mode'."],"gotchas":["The status enum for credential verification is verified/rejected/timeout/error/pending, not generic names like \"processing\"/\"success\"/\"failed\"; MFA is handled via a separate sub-flow with its own submit-code endpoint.","Arcadia's docs cover more than one product/API generation under the same domain — a newer Connect/Plug/Bundle platform versus an older 'Utility Cloud' (formerly Urjanet) product with different field names — confirm which product line your integration targets.","Webhooks are Arcadia's recommended production mechanism; polling is a fallback/complement, not a replacement — don't assume tight polling alone will be as timely as the webhook."],"contributor":"waymark-seed","created":"2026-07-08T05:33:24.985Z","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":"file-sample","at":"2026-07-08T05:33:24.985Z"},"url":"https://mcp.waymark.network/r/c8429afa-1d5a-40e2-8ad4-8b1d125c1f2e"}