---
title: "Delete an API user"
method: POST
path: "/v2/api-users/revoke"
tags: ["API User"]
---

# Delete an API user

`POST /v2/api-users/revoke`

Permanently deletes an API user and revokes its access to the Spotnana platform. This immediately 
invalidates all existing access tokens and removes the API user's ability to authenticate.

**Use this endpoint to:**
- Revoke access for an API user that is no longer needed.
- Decommission an integration or clean up unused API users.
- Free up a slot in your TMC's API user quota (default up to 5 API users per TMC).

**Best practice:**

Before revoking, ensure no active integrations are using this `clientId`. Be sure to:
1. create a new API user first
2. update your integrations to use the new credentials
3. verify they work
4. and then revoke the old API user.

**Notes:**
- This action is permanent and cannot be undone. The `clientId` and `clientSecret` are permanently invalidated.
- All active tokens for this API user are invalidated immediately. Any in-flight API requests using those tokens will fail.
- The API user being revoked must belong to the same TMC as the caller.
- Only a TMC admin can use this endpoint.

## Request body

- DeleteApiUsersRequest
  - `clientId` string — Api user client id

## Response `204`

No Content

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Bad request

---

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