Connected Accounts

Get a connect attempt

Changed on

Poll a browser connect attempt started with connectedAccounts.beginConnect. Visible only to the user who began it.

get/connected-accounts/connect/attempts/{attemptId}

Request

  • Base URL: https://api.sazabi.com/v1
  • URL: https://api.sazabi.com/v1/connected-accounts/connect/attempts/{attemptId}
  • Auth: none declared

Path parameters

attemptIdstring uuid required

Connect attempt ID to poll.

Query parameters

organizationIdstring

Organization the attempt belongs to. Auto-filled from CLI and SDK context when omitted. User tokens must supply it unless the credential's fixed scope resolves it; secret keys may omit it (the key's organization applies).

Response

OK

status'pending' | 'completed' | 'failed' | 'expired' required

Attempt state. expired means the browser flow did not complete in time, including an identity-conflict transfer offer that lapsed undecided — begin a new connect.

conflictPendingboolean

True while an identity-conflict transfer offer is awaiting the user's decision in the browser (the attempt stays pending until they choose).

conflictDeclinedboolean

True when the user declined the identity-conflict transfer offer in the browser (the account stayed connected to the other Sazabi account). A failed + identity_conflict attempt without it had no offer to decline.

errorCodestring nullable required

Reason code when status is failed (the shared OAuth callback vocabulary, e.g. vendor_denied, not_authorized).

Changes