Skip to main content

Delete a user

API operation: Open the endpoint in Scalar

Use DELETE /users/{user} to delete a user by numeric ID. The operation documented here is User.delete.

The final path parameter user identifies the user to delete by numeric ID.

The documented schema requires authentication. Non-administrators can delete only their own user account; administrators can delete other users but not their own account. Protected users and administrator accounts marked as protected in project settings cannot be deleted.

The operation may update unique identity fields before soft-deleting the user. Treat it as a destructive soft delete and confirm the target account before proceeding.

Legacy SDK example​

const response = await ordering.users(userId).delete()

Confirm the SDK package and version before using this helper.

OpenAPI reference​

Operation: DELETE /users/{user}

Path parameters

NameTypeRequiredDescription
userintegerYes—

Header parameters

NameTypeRequiredDescription
User-AgentstringNo—

Responses

CodeDescription
200OK (Envelope)
400Bad Request (ErrorResponse)
401Unauthorized
404Not Found
429Too Many Requests (ErrorResponse)
500Internal Server Error (ErrorResponse)
503Service Unavailable (ErrorResponse)
Open this operation in the API reference