Soft-delete a user

Marks the user as deleted and revokes all active sessions. The row is retained for audit purposes.

Authorization

bearerAuth

AuthorizationBearer <token>

JWT Bearer access token. Clock skew tolerance is ±60 seconds.

In: header

userId*string

Formatuuid

curl -X DELETE "https://example.com/v1/admin/users/497f6eca-6276-4993-bfeb-53cbbbba6f08"

Empty

{
  "error": "unauthenticated",
  "message": "missing or invalid bearer token",
  "request_id": "req_01abc123"
}

{
  "error": "not_found",
  "message": "the requested resource was not found",
  "request_id": "req_01abc125"
}

Was this page helpful?