/

POST

Use this API to register a user's entered time-based one-time password (TOTP) code and mark the user's software token MFA status as "verified" if successful. The request takes an access token or a session string, but not both.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/' \
--header 'X-Amz-Target;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "AccessToken": "string",
    "Session": "string",
    "UserCode": "string",
    "FriendlyDeviceName": "string"
}'

Response Example

200 - Example 1

{
    "Status": "SUCCESS",
    "Session": "string"
}

Request

Header Params

Body Params application/json

Examples

Responses

🟢200Success

application/json

Body

🟠480InvalidParameterException

🟠481ResourceNotFoundException

🟠482InvalidUserPoolConfigurationException

🟠483NotAuthorizedException

🟠484TooManyRequestsException

🟠485PasswordResetRequiredException

🟠486UserNotFoundException

🟠487UserNotConfirmedException

🟠488InternalErrorException

🟠489EnableSoftwareTokenMFAException

🟠490NotAuthorizedException

🟠491SoftwareTokenMFANotFoundException

🟠492CodeMismatchException

🟠493ForbiddenException

Modified at 2023-08-15 07:11:07