Delete user

Permanently deletes a user. The caller must have permission to edit the target user.

Warning: Deletion is rejected if the user owns at least one deal. Reassign ownership of their deals first, or deactivate the user via PUT /api/users/:id with {"active": false} instead.

Path Parameters

ParameterTypeRequiredDescription
idintegerYesUser unique identifier

Response

  • 204 No Content: User successfully deleted
  • 400 Bad Request: User still owns deals
  • 401 Unauthorized: Invalid or missing API key
  • 403 Forbidden: Not allowed to delete this user
  • 404 Not Found: User not found
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Responses
204

Resource deleted

401

Unauthorized

404

Resource not found

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here!