# Delete an API user

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.

Endpoint: POST /v2/api-users/revoke
Version: v2

## Request fields (application/json):

  - `clientId` (string)
    Api user client id

## Response 401 fields (application/json):

  - `debugIdentifier` (string)
    Link to debug the error internally.

  - `errorMessages` (array)

  - `errorMessages.errorCode` (string)
    Error code to identify the specific errors.

  - `errorMessages.message` (string)
    Message containing details of error.

  - `errorMessages.errorParameters` (array)
    Error message parameters.

  - `errorMessages.errorParameters.name` (string)
    Parameter name

  - `errorMessages.errorParameters.value` (string)
    Parameter value

  - `errorMessages.errorDetail` (string)
    More details about the error.

## Response 403 fields (application/json):

  - `debugIdentifier` (string)
    Link to debug the error internally.

  - `errorMessages` (array)

  - `errorMessages.errorCode` (string)
    Error code to identify the specific errors.

  - `errorMessages.message` (string)
    Message containing details of error.

  - `errorMessages.errorParameters` (array)
    Error message parameters.

  - `errorMessages.errorParameters.name` (string)
    Parameter name

  - `errorMessages.errorParameters.value` (string)
    Parameter value

  - `errorMessages.errorDetail` (string)
    More details about the error.

## Response 404 fields (application/json):

  - `debugIdentifier` (string)
    Link to debug the error internally.

  - `errorMessages` (array)

  - `errorMessages.errorCode` (string)
    Error code to identify the specific errors.

  - `errorMessages.message` (string)
    Message containing details of error.

  - `errorMessages.errorParameters` (array)
    Error message parameters.

  - `errorMessages.errorParameters.name` (string)
    Parameter name

  - `errorMessages.errorParameters.value` (string)
    Parameter value

  - `errorMessages.errorDetail` (string)
    More details about the error.


## Response 204 fields