reset-users-e2e-key.md

Reset Users E2E Key

Reset the E2E key for a user in the workspace.

{% hint style="info" %}

• It requires the edit-other-user-e2ee permission.
• It requires two-factor authentication. {% endhint %}

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.

{% tabs %} {% tab title="Authorization" %}

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

{% endtab %}

{% tab title="No Permission" %}

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

{% endtab %}

{% tab title="Invalid User" %}

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

{% endtab %}

{% tab title="TOTP Required" %}

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

{% endtab %}

{% tab title="Invalid TOTP" %}

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

{% endtab %} {% endtabs %}

Change Log

Version	Description
3.6.0	Added