Poll a connect session until the browser OAuth completes

GET 
/auth/social-connect/poll/:session_id

Requires the SAME API key that started the session. Resolves to completed (with the connected account) once an account for the session's platform appears (or, for reconnect, the target account's token refreshes) after the session started. Other statuses: pending, expired, cancelled.

Request

Responses

200

Session status

400

Validation error — see error.code and error.details

401

Missing/invalid/revoked/expired API key (codes invalid_api_key, api_key_revoked, api_key_expired, api_key_required, auth_failed). Auth-layer 401s omit error.retryable and meta.request_id.

402

No active subscription (code subscription_required — the error object also carries subscription_status), or insufficient AI credits (insufficient_credits) / paid plan required (upgrade_required).

403

API key missing the required scope (insufficient_scope), storage quota exceeded (storage_quota_exceeded), or account limit reached (account_limit_reached)

404

Resource not found in your organization/workspace (not_found)

500

Internal error (internal_error and endpoint-specific 5xx codes). Retryable.