Delete user

DELETE/api/v1/users/{user_id}

Permanently delete a user and all their business associations. Requires a JSON body with 'confirm_password' — the calling user's own account password.

Operation ID: delete_user_api_v1_users__user_id__delete·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

user_idstring · uuidrequired

Request body

Schema: UserDeleteRequest

confirm_passwordstring · passwordrequired: The calling user's own account password, retyped at the moment of the request. Verified against Clerk before anything is deleted; a wrong password rejects the request with 403 and changes nothing.

Responses

200Successful Response

Schema: app__core__success__MessageResponse

successboolean
messagestring
codestring

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError

5 fields

locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject

Code samples

DELETE/api/v1/users/{user_id}

bash

curl -X DELETE 'https://api.ondayzero.com/api/v1/users/{user_id}' \
  -H 'Authorization: Bearer dz_your_token' \
  -H 'x-business-id: YOUR_BUSINESS_ID' \
  -H 'Content-Type: application/json' \
  -d '{
  "confirm_password": "string"
}'