DELETE
/organization/users/{user_id}Delete an organization user
Deletes a user from the organization. Use this operation to remove a user who is no longer part of the organization. The response confirms deletion and includes the user's ID.
user_idstringrequired
The ID of the user to delete.
200Returns a deletion confirmation with the user ID and a `deleted` value.
objectstringrequired
idstringrequired
deletedbooleanrequired
400Returned when the request is invalid or the user cannot be removed in their current state.
errorobjectrequired
403Returned when the caller is not permitted to delete the user.
errorobjectrequired
Details about the permission error.
404Returned when the user is not found in the organization.
errorobjectrequired
429Returned when the request rate limit is exceeded.
errorobjectrequired
Error handling
The user_id path parameter must identify a user in the organization; a 404 is returned if the user is not found. A 400 is returned when the request is invalid or the user cannot be removed in their current state. A 403 indicates the authenticated user is not permitted to delete the user, and a 429 indicates the request rate limit was exceeded.