---
title: "Legacy alias for removing land tokens from a user's account (realtor/admin only). Prefer /api/v1/realtor/tokens/remove."
method: POST
path: "/api/v1/users/tokens/remove"
tags: ["users"]
---

# Legacy alias for removing land tokens from a user's account (realtor/admin only). Prefer /api/v1/realtor/tokens/remove.

`POST /api/v1/users/tokens/remove`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/api/v1/users/tokens/remove`
- Auth: HTTP bearer

Legacy alias for removing land tokens from a user's account (realtor/admin only). Prefer /api/v1/realtor/tokens/remove.

## Request body

- object
  - `targetUserId` string, required: Discord ID of user to remove tokens from
  - `amount` number, required: Number of land tokens to remove
  - `memo` string, required: Reason for removing land tokens

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `userId` string: Discord ID of user whose tokens were removed
    - `amountRemoved` number: Number of land tokens removed
    - `newBalance` number: User's new land token balance
    - `message` string: Success message
  - `meta` object, required
    - `timestamp` number, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `422`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/farmersonly/apis/farmersonly-club-api.md) - [All operations](https://skmtc.dev/farmersonly/apis/farmersonly-club-api/llms.txt) - [OpenAPI document](https://skmtc.dev/farmersonly/apis/farmersonly-club-api/revisions/b4fa9123ba90?raw)
