---
title: "Deletes the specified API user."
method: DELETE
path: "/apiusers/{apiUserId}"
tags: ["apiUsers"]
---

# Deletes the specified API user.

`DELETE /apiusers/{apiUserId}`

## Request

- Base URL: `https://api.awork.com/api/v1`
- URL: `https://api.awork.com/api/v1/apiusers/{apiUserId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/awork-io/apis/awork-io/docs/apiusers/:apiUserId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Deletes the specified API user and revokes its access.

<Check title="Required Permissions" icon="key">The user must be an admin or have `workspace-manage-config:write` permissions.</Check>

## Path parameters

- `apiUserId` string, uuid, required

## Response `204`

No Content

- object

## Other responses

- `404`: Not Found

## Changes

- **2026-09-17** `1556e0487867`: 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `oauth2` was added to the API
- **2026-09-12** `8e46cf415581`: 1 info
  - api operation id `DeleteApiUserById` removed and replaced with `apiUsers_DeleteApiUserById`

[Operation history](https://skmtc.dev/awork-io/apis/awork-io/changes/apiusers/:apiUserId/delete.md)

---

[API](https://skmtc.dev/awork-io/apis/awork-io.md) - [All operations](https://skmtc.dev/awork-io/apis/awork-io/llms.txt) - [OpenAPI document](https://skmtc.dev/awork-io/apis/awork-io/revisions/81151fac7e79?raw)