Go to developer

KeyraTimeoutError

An SDK wait helper exceeded its timeout before a terminal success.

On this page
Clienttimeoutpartner-2faoauthsharedtypescriptwebjava

Code: KeyraTimeoutError · Shape: sdk_client

Meaning

An SDK wait helper exceeded its timeout before a terminal success.

Likely causes

  1. User never completed enrollment/challenge/OAuth
  2. Polling wrong id
  3. Timeout shorter than user completion time

How to diagnose

  • Partner challenge wait default ~120s; enrollment wait default ~600s (TypeScript)
  • Web OAuth default timeoutMs 120000

How to fix

  • Start a new enrollment/challenge/verify
  • Ensure UI polls the original id
  • Optionally raise timeout only if product UX requires it

Retry behavior

Optional — start a new flow after timeout.

API: GET /v1/auth/challenge/{challengeId}, GET /v1/identities/enroll/{enrollmentId}/status

SDK: waitForChallengeApproval(), waitForEnrollment(), verifyWithPopup()

Troubleshooting: partner-2fa, oauth

Guides: Authentication, Enrollment