Auth

Verify pending SMS MFA enrollment

Requires an authenticated user session. MFA factor enrollment and unenrollment require recent step-up where configured, write audit events, and revoke refresh sessions after factor state changes. Enforces bounded failed-attempt counters, stores only the phone needed for MFA, and returns a masked phone value.

post/auth/mfa/sms/verify

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

codestring required

Response

JSON response

oktrue required
enabledboolean
verifiedboolean
phonestring
expiresAtstring date-time

Changes

Changed in 1 of the 9 revisions of this API.1