API Documentation
Delete a team member using their user ID.
Path parameters
id(string) - Team member user ID (UUID)
Required query parameters
confirm_email(string) - Must match the user's email address
Behavior
- Removes the user from the API key's organization.
- If this was their last organization, scrubs their email, name, avatar, timezone, login credentials, notification settings, and password reset tokens.
- Revokes active API keys created by that user in this organization.
- Preserves historical conversations, messages, notes, and audit records.
- If the user belongs to another organization, only this organization's membership is removed.
- Returns an error when removing the organization's last admin.
Response
id(string) - User ID (UUID)status(string) - deleted when personal data was scrubbed, or removed when the user still belongs to another organizationpersonal_data_scrubbed(boolean) - Whether personal/authentication data was scrubbedapi_keys_revoked(integer) - Active API keys revoked because they were created by the deleted user
