STsteward-fi
Auth

Complete a TOTP MFA login challenge

Changed on

Consumes exactly one pending TOTP MFA challenge using either a six-digit TOTP code or a recovery code. Consumes a pending MFA challenge atomically, rate-limits invalid attempts, re-checks active tenant membership before session issuance, and returns no-store session tokens only after verification.

post/auth/mfa/totp/complete

Request

Headers

X-Steward-Request-Timestampstring

Unix seconds, Unix milliseconds, or HTTP/ISO timestamp. Sensitive mutating routes require this or X-Steward-Request-Expires-At when request-expiry or request signatures are enforced.

X-Steward-Request-Expires-Atstring

Unix seconds, Unix milliseconds, or HTTP/ISO expiry time. Sensitive mutating routes require this or X-Steward-Request-Timestamp when request-expiry or request signatures are enforced.

X-Steward-Signaturestring

Authorization signature for sensitive mutating routes when STEWARD_REQUIRE_AUTH_SIGNATURE=true or production enforcement is enabled. Use v1=<hmac-sha256> or p256=<signature>.

X-Steward-Signing-Key-Idstring

Tenant request-signing key id used to select a managed HMAC signing key. Required when signing with a managed tenant key; omit only for static or app-client signing secrets.

Idempotency-Keystring

Required for signed sensitive requests and recommended for all sensitive mutating requests. Replays are scoped to authenticated or explicitly signed contexts.

Request body

OR

Response

JSON response

oktrue required
tokenstring required
refreshTokenstring required
expiresIninteger required
userobject

Changes