---
title: "Overwrite an item's HS code"
method: POST
path: "/items/{id}/hs-code/override"
tags: ["Items"]
---

# Overwrite an item's HS code

`POST /items/{id}/hs-code/override`

Stores a user-corrected HS code for the item as a durable override that survives AI re-classification. Chapter/heading/subheading are derived from the code.

## Path parameters

- `id` string, required

## Request body

- ModelsHSCodeOverrideRequest
  - `description` string
  - `hs_code` string
  - `note` string

## Response `200`

OK

- ModelsItemHSCode
  - `chapter` string — First 2 digits
  - `confidence_level` string — "high"/"medium"/"low"; empty for override
  - `confidence_score` number — carried over when verified; nil for override
  - `created_at` string
  - `decided_at` string
  - `decided_by` string — user email
  - `heading` string — First 4 digits
  - `hs_code` string — 6-10 digit HS/HTS code
  - `hs_code_description` string — Description of the HS code
  - `id` string
  - `item_id` string
  - `note` string — optional user note (esp. for overrides)
  - `source` string — "verified" or "override"
  - `source_suggestion_id` string — provenance of the verified suggestion
  - `subheading` string — First 6 digits
  - `updated_at` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/resourcly/apis/resourcly-api.md) · [All operations](https://skmtc.net/resourcly/apis/resourcly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/resourcly/resourcly-api/revisions/7f97d8cd0f1e/schema)