Error reference

Setup expired

Start two-factor setup again — the pending code expired.

Code: mfa_setup_required
HTTP status: 409
Category: conflict
Severity: warn
Retryable: No
Domain: auth

How to fix

Complete two-factor authentication, then retry.

Example response

Every error is returned as application/problem+json (RFC 9457). The detail is the specific, actionable message; the code is stable and safe to branch on.

{
  "type": "https://skedcast.com/errors/mfa_setup_required",
  "title": "Setup expired",
  "status": 409,
  "category": "conflict",
  "code": "mfa_setup_required",
  "detail": "Start two-factor setup again — the pending code expired.",
  "correlationId": "c-1f2e3d4c-…",
  "severity": "warn",
  "action": "mfa"
}

Handle it in code

try {
  await skedcast.posts.create(input);
} catch (err) {
  if (err instanceof SkedcastApiError && err.code === 'mfa_setup_required') {
    // Start two-factor setup again — the pending code expired.
  }
}