> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Label

> Set or clear the label on an imported token

Sets the label on an import record, or clears it. A label is your own short text for grouping imports, for example `Real estate`. It is private to your instance and carries no meaning on chain. Removing the import removes its label.

An instance keeps at most 50 different labels.

## Path Parameters

**tokenAddress** `string` *required*

The imported contract address.

## Body Parameters

**label** `string` *required*

Text of at most 40 characters, without control characters and without angle brackets. Whitespace is collapsed and trimmed before the label is stored.

Send `null` to clear the label. An empty string clears it as well.

Only the `label` field is accepted.

## Response Fields

**data** `object`

**tokenAddress** `string`

The address of the import.

**label** `string`

The stored label, or `null` when cleared.

**previousLabel** `string`

The label before this call, or `null` when there was none.

**updatedAt** `string`

ISO 8601 timestamp of the write.

```bash cURL theme={null}
curl -X PUT "https://api.trusset.org/external-tokens/api/0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f/label" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"label": "Real estate"}'
```

```typescript TypeScript theme={null}
await fetch(
  `https://api.trusset.org/external-tokens/api/${tokenAddress}/label`,
  {
    method: 'PUT',
    headers: { 'X-API-Key': 'trusset_your_key_here', 'Content-Type': 'application/json' },
    body: JSON.stringify({ label: null })
  }
);
```

```json Response theme={null}
{
  "success": true,
  "data": {
    "tokenAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
    "label": "Real estate",
    "previousLabel": null,
    "updatedAt": "2026-11-21T12:22:00.000Z"
  }
}
```

## Rate Limit

Strict: 10 requests per minute.

## Error Codes

| Code | HTTP | Cause |
| - | - | - |
| `INVALID_LABEL` | `400` | `label` is not text of at most 40 characters, or carries a control character or an angle bracket. Send `null` to clear |
| `LABEL_LIMIT_REACHED` | `400` | Your instance already keeps 50 different labels |
| `IMPORT_NOT_FOUND` | `404` | No active import for that address on your instance |
| `LABELS_UNAVAILABLE` | `503` | Labels are unavailable just now |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.