Delete an end user.

DELETE

/api/admin/users/{id}

Code sample: Shell / cURL

curl --request DELETE \
  --url https://auth.example.com/api/admin/users/example \
  --header 'Authorization: Bearer <token>'

Delete User in the Users area. The operation changes tenant state and should be protected by the documented admin authorization and audit controls. An active account legal hold rejects deletion with 409.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Path Parameters

id

required

string

Header Parameters

X-Tenant-Id

string

Tenant selector for multi-tenant admin requests.

Responses

200

Successful delete response.

Media type application/json

object

success

required

boolean

message

required

string

key

additional properties

Example

{
  "success": true,
  "message": "User deleted successfully"
}

404

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

409

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}