Save Passkey Settings
Saves the project's passkey authentication settings.
Membership settings control how authentication and authorization behave for your project — allowed sign-in methods, registration rules, password complexity, and passkey options.
This endpoint creates the passkey settings; the response returns its id.
JWT Bearer Authorization
The CodeMash API version used to fetch data from the API. If not specified, the last version will be used. E.g.: v3
Saves the project's passkey authentication settings.
CorrelationId for each request
Specify culture code when your response from the API should be localised. E.g.: en
TimeZone
The CodeMash API version used to fetch data from the API. If not specified, the last version will be used. E.g.: v3
Target environment for this request (e.g. TEST, STAGING). Optional — when omitted the request runs against PROD. Can be passed in a header as norbix-env.
ID of your project. Can be passed in a header as norbix-project-id.
Whether the email + passkey sign-in flow is enabled for the project.
Email verification code lifetime, in minutes. Allowed range: 3-15.
Maximum passkeys a single user may register. Allowed range: 1-20.
Number of recovery codes generated at signup. Allowed range: 5-20.
Whether recovery codes are generated automatically at signup.
Accepted authenticator types: 'Any', 'Platform', or 'CrossPlatform'.
Per-project opt-in for magic-link account recovery (off by default).
Absolute refresh-token lifetime, in days. Allowed range: 7-90.
Optional explicit WebAuthn RP-ID — a bare DNS host (e.g. 'app.example.com', no scheme/port/path). Leave null/empty to derive it from the project's CORS origins. WARNING: changing this value invalidates every existing passkey on the project — set it once before going live and avoid changing it afterward.
Success
EmptyResponse
POST /{version}/membership/passkey/settings HTTP/1.1
Host: hub.norbix.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 334
{
"enabled": true,
"codeTtlMinutes": 1,
"maxCredentialsPerUser": 1,
"recoveryCodeCount": 1,
"generateRecoveryCodesAtSignup": true,
"authenticatorAttachment": "text",
"allowMagicLinkRecovery": true,
"refreshTokenTtlDays": 1,
"rpId": "text",
"projectId": "text",
"env": "text",
"cultureCode": "text",
"timeZoneId": "text",
"correlationId": "text",
"version": "text"
}Success
{
"success": {
"responseStatus": {
"isSuccess": true
}
},
"responseStatus": {
"isSuccess": true
}
}In Cloud
Manage this visually in Cloud — see Membership → Settings.
Use it from code
Every Norbix SDK exposes this endpoint as a method — see Save Passkey Settings in the SDK reference, with examples in every language.
Last updated