---
title: "Delete a user (admin)"
method: DELETE
path: "/admin/users/{id}"
tags: ["admin"]
---

# Delete a user (admin)

`DELETE /admin/users/{id}`

Delete a user. With mode=now the user is removed immediately. With mode=scheduled (the default, matching the CLI) the user receives a confirmation email and is scheduled for deletion just like a self-initiated account deletion.

## Path parameters

- `id` integer, required

## Query parameters

- `mode` string

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `404` — Not Found

## Changes

- **2026-04-20** `3499c34cade4` — 1 info
  - endpoint added
- **2025-07-28** `d7c1f946dc48` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/go-vikunja/apis/vikunja-api/changes/admin/users/:id/delete.md)

---

[API](https://skmtc.dev/go-vikunja/apis/vikunja-api.md) · [All operations](https://skmtc.dev/go-vikunja/apis/vikunja-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/go-vikunja/vikunja-api/revisions/feb3f68bbdf1/schema)