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

# Replace the blocklist

> Bulk-replace your organization's blocklist in one call.

Requires the `classify:read` scope.

<Warning>
  This is a **full replacement**: your existing blocklist is wiped first, then
  the supplied entries are loaded. Send an empty `entries` array to clear the
  blocklist entirely.
</Warning>

<ParamField body="entries" type="array" required>
  Up to 5000 entries. Each entry:

  * `hs_code` (required) — 2–13 chars, digits and dots
  * `country_code` or `destination_country` — ISO alpha-2 (defaults to
    `GLOBAL` when both are omitted)
  * `reason` — optional note
</ParamField>

<ResponseField name="count" type="number">
  Number of entries loaded.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://{partner}.mytraddal.com/admin/api/v1/classify/blocklist/import \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer {access_token}' \
    -d '{
      "entries": [
        { "hs_code": "4202.92.3131", "country_code": "US", "reason": "Ruled out by our broker" },
        { "hs_code": "6404.11", "country_code": "US" }
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "success": true,
    "message": "2 blocklist entries imported",
    "count": 2
  }
  ```
</ResponseExample>