Delete User

Permanently delete a user and cascade cleanup across all of their related data

DELETE /:projectId/api/v7/users/:userId

Delete User

cURL

curl --request DELETE \
  --url https://api.sublay.io/api/v6/:projectId/api/v7/users/:userId

Permanently deletes the specified user and cascades cleanup across all of their related records. Reactions, files, follows, connections, notifications, collections, reports, and mentions are removed, and the user’s entities and comments are stripped of their authored content. This is the same full-cascade delete performed from the dashboard.

This is a hard, irreversible delete. It cannot be undone.

Authentication

Requires a service or master key. User auth tokens are rejected with a 403.

Path Parameters

userId · string · required

The Sublay user ID (UUID) to delete.

Response

On success, returns HTTP 204 No Content with an empty body.

Error Responses

Elevated Auth Required — 403

{
  "error": "Service or master key required.",
  "code": "auth/elevated-auth-required"
}

User Not Found — 404

{
  "error": "User not found.",
  "code": "user/not-found"
}

Invalid Params — 400

{
  "error": "...",
  "code": "user/invalid-params"
}

Server Error — 500

{
  "error": "Failed to delete the user.",
  "code": "user/server-error"
}

See Also

• Node SDK: deleteUser
• User data model