# Remove a token and optionally ban the domain

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

**POST** `/admin/remove-token`

Base URL: `https://{fqdn}`

Remove a token and optionally ban the domain

## Authorization

- BearerToken (http, bearer)
- BSVMutualAuth (http, bearer)

## Body

Content type: `application/json`

- `txid` (string, required)
- `outputIndex` (integer, required)
- `service` (string)
- `ban` (boolean)
  Also ban the outpoint.
- `banDomain` (boolean)
  Also ban the domain associated with this token.

Example:

```json
{
  "txid": "string",
  "outputIndex": 0,
  "service": "string",
  "ban": true,
  "banDomain": true
}
```

## Responses

### 200

Token removed.

- `status` (string, required)
- `message` (string)

Example:

```json
{
  "status": "string",
  "message": "string"
}
```

### 400

Bad request — validation error or missing required field.

- `status` (string, required)
- `message` (string, required)
- `code` (string)
  Stable machine-readable error code (see specs/errors.md).

Example:

```json
{
  "status": "string",
  "message": "string",
  "code": "string"
}
```

### 401

No authentication credentials provided.

- `status` (string, required)
- `message` (string, required)
- `code` (string)
  Stable machine-readable error code (see specs/errors.md).

Example:

```json
{
  "status": "string",
  "message": "string",
  "code": "string"
}
```

### 403

Credentials provided but insufficient.

- `status` (string, required)
- `message` (string, required)
- `code` (string)
  Stable machine-readable error code (see specs/errors.md).

Example:

```json
{
  "status": "string",
  "message": "string",
  "code": "string"
}
```