> ## 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 Image

> Set or clear the icon on an imported token

Replaces the icon on an import record. The icon is presentation only. Nothing reads it as a fact about the asset.

## Path Parameters

<ParamField path="tokenAddress" type="string" required>The imported contract address.</ParamField>

## Body Parameters

<ParamField body="imageURI" type="string" required>
  An `https://` or `ipfs://` URI, at most 1024 characters. Send `null` to clear the icon.

  An empty string is not a valid value. It is rejected rather than treated as a clear.

  Pin a file first with [Upload File](/endpoints/tokenization/upload-file) if you do not host the image yourself.
</ParamField>

## Response Fields

<ResponseField name="data" type="object">
  <Expandable>
    <ResponseField name="tokenAddress" type="string">The address, lowercased.</ResponseField>
    <ResponseField name="imageURI" type="string">The stored icon, or `null` when cleared.</ResponseField>
    <ResponseField name="updatedAt" type="string">ISO 8601 timestamp of the write.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PUT "https://api.trusset.org/external-tokens/api/0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f/image" \
    -H "X-API-Key: trusset_your_key_here" \
    -H "Content-Type: application/json" \
    -d '{"imageURI": "ipfs://bafkreigh2akiscaildc7fh4dqwv6zqm4"}'
  ```

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

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "tokenAddress": "0x9f8c1d4b2e7a3056c1b8f4d29e0a7c3518b6d24f",
      "imageURI": "ipfs://bafkreigh2akiscaildc7fh4dqwv6zqm4",
      "updatedAt": "2026-09-05T12:22:00.000Z"
    }
  }
  ```
</ResponseExample>

## Error Codes

| Code                | HTTP  | Cause                                                                            |
| ------------------- | ----- | -------------------------------------------------------------------------------- |
| `INVALID_ADDRESS`   | `400` | `tokenAddress` is not a valid address                                            |
| `INVALID_IMAGE_URI` | `400` | Not a valid `https` or `ipfs` URI, or over 1024 characters. Send `null` to clear |
| `IMPORT_NOT_FOUND`  | `400` | No active import for that address on your instance                               |