Skip to main content

​
DELETE /api/v1/users/

Permanently removes a user from your environment and deletes all associated data. Use this endpoint when you need to completely remove a user account. This action deletes the user’s profile, memberships, and all related data across all organizations.
This operation cannot be undone. All user data will be permanently deleted.

​
Request

​
Path Parameters

​
id
string
required
System-generated user ID. Must start with ‘usr_’ (19-25 characters).
usr_123

​
Query Parameters

​
external_id
string
External system identifier from connected directories. Use this to delete a user by your own ID instead of Scalekit’s ID.
ext_12345a67b89c

​
Response

​
200
success
User successfully deleted. No content returned.

​
Examples

    ​
    Error Responses

    ​
    200
    success
    User successfully deleted
    ​
    404
    error
    User not found

    ​
    What Gets Deleted

    When you delete a user, the following data is permanently removed:
    • User profile information (name, email, phone, etc.)
    • All organization memberships
    • User metadata and custom attributes
    • External identity connections
    • User sessions
    • Authentication history

    ​
    Use Cases

    • GDPR/Privacy Compliance: Remove user data when requested
    • Account Cleanup: Delete test or inactive accounts
    • Security: Remove compromised accounts
    • Offboarding: Clean up departed employee accounts

    Build docs developers (and LLMs) love

    Get started for freeTalk to us