Admin

Delete user

POST/api/v1/users/:id/delete

Deletes a user account on the platform's behalf — for policy violations or support-driven closures. Admin-only.

Requires Authorization

ADMIN only

Authenticated action

Path parameters

idstringrequired

User ID.

Body parameters

reasonstring

Reason recorded and referenced in the notification sent to the user.

Request

curl --request POST \
  --url https://api.swiftgoma.com/api/v1/users/:id/delete \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "reason": "<reason>"
}'

200Example response

{
  "success": true,
  "data": {
    "deleted": true
  }
}