Reset Users E2E Key

Reset the E2E key for a user in the workspace.

• It requires the edit-other-user-e2ee permission.

• It requires two-factor authentication.

HTTP Method	URL	Requires Auth
POST	/api/v1/users.resetE2EKey	yes

Body Parameters

Key	Example Value	Description
userId*	Q29yYlEZEByCLOQa70-QGNLRjVRhshsN2Sky6-FLAlMXbhU	The userId of the user whose e2e key you want to reset. You can also use the username.

Example Call

curl --location 'http://localhost:3000/api/v1/users.resetE2EKey' \
--header 'x-auth-token: Q29yYlEZEByCLOQa70-QGNLRjVRN2Sky6-FLAlMXbhU' \
--header 'x-user-id: GonjPyg3gB3Z9ur9s' \
--header 'x-2fa-code: 175842' \
--data '{
    "userId":"GonjPyg3gB3Z9ur9s"
}'

Example Response

{
    "success": true
}

Error

Any of the following errors can occur on the endpoint.

• Authorization: Requires an authentication token for the request to be made.

• No Permission: This occurs when the authenticated user doesn't have the edit-other-user-e2ee permission.

• Invalid User: This occurs when the userId or username in the body is invalid.

• TOTP Required: Requires two-factor authentication for the request to be made.

• Invalid TOTP: Requires a valid two-factor authentication code.

Authorization

{
    "status": "error",
    "message": "You must be logged in to do this."
}

No Permission

{
    "success": false,
    "error": "Not allowed [error-not-allowed]",
    "errorType": "error-not-allowed"
}

Invalid User

{
    "success": false,
    "error": "The required \"userId\" or \"username\" param provided does not match any users [error-invalid-user]",
    "errorType": "error-invalid-user"
}

TOTP Required

{
    "success": false,
    "error": "TOTP Required [totp-required]",
    "errorType": "totp-required",
    "details": {
        "method": "totp",
        "codeGenerated": false,
        "availableMethods": [
            "totp"
        ]
    }
}

Invalid TOTP

{
    "success": false,
    "error": "TOTP Invalid [totp-invalid]",
    "errorType": "totp-invalid",
    "details": {
        "method": "totp",
        "codeGenerated": false
    }
}

Change Log

Version	Description
3.6.0	Added