diff --git a/packages/core/src/routes/experience/anonymous-routes/index.openapi.json b/packages/core/src/routes/experience/anonymous-routes/index.openapi.json index ef851cb287c..0e7bba37ba1 100644 --- a/packages/core/src/routes/experience/anonymous-routes/index.openapi.json +++ b/packages/core/src/routes/experience/anonymous-routes/index.openapi.json @@ -3,7 +3,7 @@ "/api/experience/sso-connectors": { "get": { "operationId": "GetEnabledSsoConnectors", - "summary": "Get all the enabled SSO connectors by the given email's domain", + "summary": "Get enabled SSO connectors by the given email's domain", "description": "Extract the email domain from the provided email address. Returns all the enabled SSO connectors that match the email domain.", "parameters": [ { diff --git a/packages/core/src/routes/experience/experience.openapi.json b/packages/core/src/routes/experience/experience.openapi.json index 5a69427098e..146c066a87a 100644 --- a/packages/core/src/routes/experience/experience.openapi.json +++ b/packages/core/src/routes/experience/experience.openapi.json @@ -8,9 +8,9 @@ "paths": { "/api/experience": { "put": { - "operationId": "InitExperienceInteraction`", - "summary": "Init a new experience interaction", - "description": "Init a new experience interaction with the given interaction type. Any existing experience interaction data will be cleared.", + "operationId": "InitInteraction", + "summary": "Init new interaction", + "description": "Init a new experience interaction with the given interaction type. Any existing interaction data will be cleared.", "responses": { "204": { "description": "A new experience interaction has been successfully initiated." @@ -21,7 +21,7 @@ "/api/experience/interaction-event": { "put": { "operationId": "UpdateInteractionEvent", - "summary": "Update current experience interaction event", + "summary": "Update interaction event", "description": "Update the current experience interaction event to the given event type. This API is used to switch the interaction event between `SignIn` and `Register`, while keeping all the verification records data.", "requestBody": { "content": { @@ -52,7 +52,7 @@ "/api/experience/identification": { "post": { "operationId": "IdentifyUser", - "summary": "Identify the user within the current experience interaction using the provided verification data", + "summary": "Identify user for the current interaction", "description": "This API identifies the user based on the verificationId within the current experience interaction:
- `SignIn` and `ForgotPassword` interactions: Verifies the user's identity using the provided `verificationId`.
- `Register` interaction: Creates a new user account using the profile data from the current interaction. If a verificationId is provided, the profile data will first be updated with the verification record before creating the account. If not, the account is created directly from the stored profile data.", "requestBody": { "content": { @@ -100,8 +100,8 @@ }, "/api/experience/submit": { "post": { - "operationId": "SubmitExperienceInteraction", - "summary": "Submit experience interaction", + "operationId": "SubmitInteraction", + "summary": "Submit interaction", "description": "Submit the current interaction.
- Submit the verified user identity to the OIDC provider for further authentication (SignIn and Register).
- Update the user's profile data if any (SignIn and Register).
- Reset the password and clear all the interaction records (ForgotPassword).", "responses": { "200": { diff --git a/packages/core/src/routes/experience/profile-routes.openapi.json b/packages/core/src/routes/experience/profile-routes.openapi.json index 2c8acbb1fe3..dcc8adf76e5 100644 --- a/packages/core/src/routes/experience/profile-routes.openapi.json +++ b/packages/core/src/routes/experience/profile-routes.openapi.json @@ -3,7 +3,7 @@ "/api/experience/profile": { "post": { "operationId": "UpdateUserProfile", - "summary": "Fulfill user profile data", + "summary": "Update user profile data", "description": "Adds user profile data to the current experience interaction.
- For `Register`: The profile data provided before the identification request will be used to create a new user account.
- For `SignIn` and `Register`: The profile data provided after the user is identified will be used to update the user's profile when the interaction is submitted.
- `ForgotPassword`: Not supported.", "requestBody": { "content": { @@ -35,7 +35,7 @@ "description": "Entity not found.
- `session.identifier_not_found:` (`SignIn` interaction only) The current interaction is not identified yet. All profile data must be associated with a identified user.
- `session.verification_session_not_found:` The verification record is not found." }, "403": { - "description": "`SignIn` interaction only: Multi-Factor Authentication (MFA) is enabled for the user but has not been verified. The user must verify the MFA before updating the profile data." + "description": "`SignIn` interaction only: MFA is enabled for the user but has not been verified. The user must verify the MFA before updating the profile data." }, "422": { "description": "The user profile can not been processed, check error message for more details.
- The profile data is invalid or conflicts with existing user data.
- The profile data is already in use by another user account." @@ -47,7 +47,7 @@ "put": { "operationId": "ResetUserPassword", "summary": "Reset user password", - "description": "Update the user's password. (`ForgotPassword` interaction only)", + "description": "Reset the user's password. (`ForgotPassword` interaction only)", "requestBody": { "content": { "application/json": { @@ -80,7 +80,7 @@ "/api/experience/profile/mfa/mfa-skipped": { "post": { "operationId": "SkipMfaBindingFlow", - "summary": "Skip Multi-Factor Authentication (MFA) binding flow", + "summary": "Skip MFA binding flow", "description": "Skip MFA verification binding flow. If the MFA is enabled in the sign-in experience settings and marked as `UserControlled`, the user can skip the MFA verification binding flow by calling this API.", "responses": { "204": { @@ -104,7 +104,7 @@ "/api/experience/profile/mfa": { "post": { "operationId": "BindMfaVerification", - "summary": "Bind Multi-Factor Authentication (MFA) verification by verificationId", + "summary": "Bind MFA verification by verificationId", "description": "Bind new MFA verification to the user profile using the verificationId.", "requestBody": { "content": { diff --git a/packages/core/src/routes/experience/verification-routes/backup-code-verification.openapi.json b/packages/core/src/routes/experience/verification-routes/backup-code-verification.openapi.json index b8c8e001f00..a0395a1a9ef 100644 --- a/packages/core/src/routes/experience/verification-routes/backup-code-verification.openapi.json +++ b/packages/core/src/routes/experience/verification-routes/backup-code-verification.openapi.json @@ -2,9 +2,9 @@ "paths": { "/api/experience/verification/backup-code/generate": { "post": { - "operationId": "GenerateNewBackupCodes", + "operationId": "GenerateBackupCodes", "summary": "Generate backup codes", - "description": "Generate backup codes for the current user. A new BackupCode verification record will be created in the current interaction.", + "description": "Create a new BackupCode verification record with new backup codes generated. This verification record will be used to bind the backup codes to the user's profile.", "responses": { "200": { "description": "Backup codes have been successfully generated.", @@ -33,7 +33,7 @@ "post": { "operationId": "VerifyBackupCode", "summary": "Verify backup code", - "description": "Verify the provided backup code against the user's backup codes. A new BackupCode verification record will be created and marked as verified if the code is correct.", + "description": "Create a new BackupCode verification record and verify the provided backup code against the user's backup codes. The verification record will be marked as verified if the code is correct.", "requestBody": { "content": { "application/json": { diff --git a/packages/core/src/routes/experience/verification-routes/enterprise-sso-verification.openapi.json b/packages/core/src/routes/experience/verification-routes/enterprise-sso-verification.openapi.json index 5b6bb9bd0ef..0b6315d8040 100644 --- a/packages/core/src/routes/experience/verification-routes/enterprise-sso-verification.openapi.json +++ b/packages/core/src/routes/experience/verification-routes/enterprise-sso-verification.openapi.json @@ -2,9 +2,9 @@ "paths": { "/api/experience/verification/sso/{connectorId}/authorization-uri": { "post": { - "operationId": "CreateEnterpriseSSOVerification", - "summary": "Get SSO authorization URI", - "description": "Create a new EnterpriseSSO verification record and return the authorization URI for the given connector.", + "operationId": "CreateEnterpriseSsoVerification", + "summary": "Create enterprise SSO verification", + "description": "Create a new EnterpriseSSO verification record and return the provider's authorization URI for the given connector.", "requestBody": { "content": { "application/json": { @@ -50,9 +50,9 @@ }, "/api/experience/verification/sso/{connectorId}/verify": { "post": { - "operationId": "VerifyEnterpriseSSOVerification", - "summary": "Verify SSO authorization response", - "description": "Verify the SSO authorization response data and get the user's profile data from the SSO connector.", + "operationId": "VerifyEnterpriseSsoVerification", + "summary": "Verify enterprise SSO verification", + "description": "Verify the SSO authorization response data and get the user's identity from the SSO provider.", "requestBody": { "content": { "application/json": { diff --git a/packages/core/src/routes/experience/verification-routes/new-password-identity-verification.openapi.json b/packages/core/src/routes/experience/verification-routes/new-password-identity-verification.openapi.json index d3216b19cff..bc00e30bf3f 100644 --- a/packages/core/src/routes/experience/verification-routes/new-password-identity-verification.openapi.json +++ b/packages/core/src/routes/experience/verification-routes/new-password-identity-verification.openapi.json @@ -3,8 +3,8 @@ "/api/experience/verification/new-password-identity": { "post": { "operationId": "CreateNewPasswordIdentityVerification", - "summary": "Create a new password identity for new user registration use", - "description": "Create a NewPasswordIdentity verification record for the new user registration use. The verification record includes a unique user identifier and a password that can be used to verify the user's identity.", + "summary": "Create new password identity verification", + "description": "Create a NewPasswordIdentity verification record for the new user registration use. The verification record includes a unique user identifier and a password that can be used to create a new user account.", "requestBody": { "content": { "application/json": { diff --git a/packages/core/src/routes/experience/verification-routes/password-verification.openapi.json b/packages/core/src/routes/experience/verification-routes/password-verification.openapi.json index 45cf440bb4c..5c09565516e 100644 --- a/packages/core/src/routes/experience/verification-routes/password-verification.openapi.json +++ b/packages/core/src/routes/experience/verification-routes/password-verification.openapi.json @@ -3,8 +3,8 @@ "/api/experience/verification/password": { "post": { "operationId": "CreatePasswordVerification", - "summary": "Create and verify a new password verification record", - "description": "Generate a new Password verification record, which can be used to identify the user through the `Identification` API.", + "summary": "Create password verification record", + "description": "Create and verify a new Password verification record. The verification record can only be created if the provided user credentials are correct.", "requestBody": { "content": { "application/json": { diff --git a/packages/core/src/routes/experience/verification-routes/social-verification.openapi.json b/packages/core/src/routes/experience/verification-routes/social-verification.openapi.json index 3baa8ee1dac..d20890747a3 100644 --- a/packages/core/src/routes/experience/verification-routes/social-verification.openapi.json +++ b/packages/core/src/routes/experience/verification-routes/social-verification.openapi.json @@ -3,8 +3,8 @@ "/api/experience/verification/social/{connectorId}/authorization-uri": { "post": { "operationId": "CreateSocialVerification", - "summary": "Get social authorization URI", - "description": "Create a new SocialVerification record and return the authorization URI for the given connector.", + "summary": "Create social verification", + "description": "Create a new SocialVerification record and return the provider's authorization URI for the given connector.", "requestBody": { "content": { "application/json": { @@ -51,8 +51,8 @@ "/api/experience/verification/social/{connectorId}/verify": { "post": { "operationId": "VerifySocialVerification", - "summary": "Verify social authorization response", - "description": "Verify the social authorization response data and get the user's profile data from the social connector.", + "summary": "Verify social verification", + "description": "Verify the social authorization response data and get the user's identity data from the social provider.", "requestBody": { "content": { "application/json": { diff --git a/packages/core/src/routes/experience/verification-routes/totp-verification.openapi.json b/packages/core/src/routes/experience/verification-routes/totp-verification.openapi.json index 0b2288ecb71..213e992efb1 100644 --- a/packages/core/src/routes/experience/verification-routes/totp-verification.openapi.json +++ b/packages/core/src/routes/experience/verification-routes/totp-verification.openapi.json @@ -3,8 +3,8 @@ "/api/experience/verification/totp/secret": { "post": { "operationId": "CreateTotpSecret", - "summary": "Generate TOTP secret for new TOTP binding", - "description": "Creates a new TOTP secret for the user to bind a new TOTP verification to their account.", + "summary": "Create TOTP secret", + "description": "Create a new TOTP verification record and generate a new TOTP secret for the user. This secret can be used to bind a new TOTP verification to the user's profile. The verification record must be verified before the secret can be used to bind a new TOTP verification to the user's profile.", "responses": { "200": { "description": "TOTP secret successfully generated.", @@ -35,8 +35,8 @@ "/api/experience/verification/totp/verify": { "post": { "operationId": "VerifyTotpVerification", - "summary": "Verify TOTP code", - "description": "Verifies the provided TOTP code against the user's TOTP secret. If the code is correct, a new TOTP verification record will be created and marked as verified..", + "summary": "Verify TOTP verification", + "description": "Verifies the provided TOTP code against the new created TOTP secret or the existing TOTP secret. If a verificationId is provided, this API will verify the code against the TOTP secret that is associated with the verification record. Otherwise, a new TOTP verification record will be created and verified against the user's existing TOTP secret.", "requestBody": { "content": { "application/json": { diff --git a/packages/core/src/routes/experience/verification-routes/verification-code.openapi.json b/packages/core/src/routes/experience/verification-routes/verification-code.openapi.json index 8e44a277d3f..b14531d40e0 100644 --- a/packages/core/src/routes/experience/verification-routes/verification-code.openapi.json +++ b/packages/core/src/routes/experience/verification-routes/verification-code.openapi.json @@ -4,7 +4,7 @@ "post": { "operationId": "CreateAndSendVerificationCode", "summary": "Create and send verification code", - "description": "Creates a new `CodeVerification` record and sends the code to the specified identifier. The code verification can be used to verify the user's identity or bind a new identifier to the user's account.", + "description": "Create a new `CodeVerification` record and sends the code to the specified identifier. The code verification can be used to verify the given identifier.", "requestBody": { "content": { "application/json": { @@ -49,7 +49,7 @@ "post": { "operationId": "VerifyVerificationCode", "summary": "Verify verification code", - "description": "Verifies the provided verification code against the user's identifier. If successful, the verification record is marked as verified.", + "description": "Verify the provided verification code against the user's identifier. If successful, the verification record will be marked as verified.", "requestBody": { "content": { "application/json": { diff --git a/packages/core/src/routes/experience/verification-routes/web-authn-verification.openapi.json b/packages/core/src/routes/experience/verification-routes/web-authn-verification.openapi.json index 04ad8690d60..9f49a26cc79 100644 --- a/packages/core/src/routes/experience/verification-routes/web-authn-verification.openapi.json +++ b/packages/core/src/routes/experience/verification-routes/web-authn-verification.openapi.json @@ -3,8 +3,8 @@ "/api/experience/verification/web-authn/registration": { "post": { "operationId": "CreateWebAuthnRegistrationVerification", - "summary": "Create WebAuthn registration", - "description": "Creates a new WebAuthn registration verification record to allow the user to bind a new WebAuthn credential to their account.", + "summary": "Create WebAuthn registration verification", + "description": "Create a new WebAuthn registration verification record. The verification record can be used to bind a new WebAuthn credential to the user's profile.", "responses": { "200": { "description": "WebAuthn registration successfully created.", @@ -32,8 +32,8 @@ "/api/experience/verification/web-authn/registration/verify": { "post": { "operationId": "VerifyWebAuthnRegistrationVerification", - "summary": "Verify WebAuthn registration", - "description": "Verifies the WebAuthn registration response against the user's WebAuthn registration challenge. If the response is valid, the WebAuthn registration record will be marked as verified.", + "summary": "Verify WebAuthn registration verification", + "description": "Verify the WebAuthn registration response against the user's WebAuthn registration challenge. If the response is valid, the WebAuthn registration record will be marked as verified.", "requestBody": { "content": { "application/json": { @@ -77,8 +77,8 @@ "/api/experience/verification/web-authn/authentication": { "post": { "operationId": "CreateWebAuthnAuthenticationVerification", - "summary": "Initiate WebAuthn authentication", - "description": "Creates a new WebAuthn authentication verification record, allowing the user to authenticate with their WebAuthn credential.", + "summary": "Create WebAuthn authentication verification", + "description": "Create a new WebAuthn authentication verification record based on the user's existing WebAuthn credential. This verification record can be used to verify the user's WebAuthn credential.", "responses": { "200": { "description": "WebAuthn authentication successfully initiated.", @@ -109,8 +109,8 @@ "/api/experience/verification/web-authn/authentication/verify": { "post": { "operationId": "VerifyWebAuthnAuthenticationVerification", - "summary": "Verify WebAuthn authentication", - "description": "Verifies the WebAuthn authentication response against the user's authentication challenge. Upon successful verification, the WebAuthn authentication verification record will be marked as verified.", + "summary": "Verify WebAuthn authentication verification", + "description": "Verifies the WebAuthn authentication response against the user's authentication challenge. Upon successful verification, the verification record will be marked as verified.", "requestBody": { "content": { "application/json": {