/v1/connections/attemptsStarts a sign-in to the website on Fous’s own server, the same way Studio’s Connections page does. The attempt comes back working; read it with wait until it reaches challenge, then show the person the form and submit what they typed. Show the ConnectRiskAcknowledgment notice and obtain explicit authorization for each connection or reconnection before sending consent and risk_acknowledgment. Never infer permission from a task request. Needs connections:write.
Requires Authorization: Bearer $FOUS_API_KEY. Create a key.
Request body
Required. JSON.
website_urlstringrequiredlabelstringDefaults to the site.
consenttruerequiredrisk_acknowledgmentConnectRiskAcknowledgmentRequired once a managed Connect notice is active. A missing or outdated acknowledgment returns 409 risk_acknowledgment_required with the exact current notice in error.details.notice. Present its full text and affirmation, obtain explicit authorization, and send its version with accepted: true. API and agent callers attest that they obtained permission; they must not silently accept for the person.
connection_idstringSign in again for this existing connection.
fresh_loginbooleanStart from a blank browser instead of what the website remembers.
Response 200
Success
successtruerequiredOne sign-in, step by step. challenge: the website asks for something, described in form; submit the answers. working: wait. verified: confirm it. ready: the account is connected. failed: notice says why, can_retry whether another method can be tried.
Errors
Every failure is an Error: branch on error.code. The errors guide lists each code.
400401WWW-Authenticate402403404408409410413422429Retry-After500502503Retry-After504