# Update Item Updates an existing item. Partial update — only the keys sent inside item are changed, except retention, which is reset to 0 when omitted. An unknown tax.name is ignored (the current tax is kept). Endpoint: PUT /api/v3/items/{id} Version: 3.1.0 Security: apiKeyAuth ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Path parameters: - `id` (string, required) Item id ## Request fields (application/json): - `item` (object, required) Item fields accepted on create and update. Any other key inside item is ignored. - `item.code` (string) Item name/code. Values longer than 60 characters are rejected with HTTP 422 (Code for the item is too long (maximum should be 60 characters)) — they are not truncated. On update, it cannot be changed once the item is used in a non-draft document (HTTP 422 Code can't be changed because it is already associated with invoices). Example: "Item name" - `item.description` (string,null) Values longer than 200 characters are rejected with HTTP 422 (Description is too long (maximum is 200 characters)) — they are not truncated. Example: "Item description" - `item.unit_price` (number) A missing or non-numeric value is rejected with HTTP 422 (Price is not valid. Check the decimal mark and if you are inserting only numbers.). Example: 9.99 - `item.rrp` (number) Recommended retail price. On create, when omitted, it is computed as unit_price plus the item's tax. On update, an omitted value is left unchanged. Example: 12.29 - `item.unit` (string) One of: hour, day, month, unit, service, tax, other, product, article. On create, defaults to service when omitted; on update, an omitted unit is left unchanged. Example: "service" - `item.tax` (object) Tax of the item, by name. When omitted, create uses the account's default tax and update keeps the current tax. An unknown name is rejected on create with HTTP 422 (Tax must exist); on update it is ignored and the current tax is kept. - `item.tax.name` (string) Example: "IVA23" - `item.retention` (number) Retention rate (%). Defaults to 0 when omitted. Example: 2 ## Response 200 fields (application/json): - `item` (object) - `item.id` (integer) Example: 1 - `item.code` (string) Example: "Item name" - `item.description` (string,null) Example: "Item description" - `item.unit_price` (number) Example: 9.99 - `item.rrp` (number) Example: 12.29 - `item.unit` (string) One of: hour, day, month, unit, service, tax, other, product, article. Example: "service" - `item.tax` (object) - `item.tax.name` (string) Example: "IVA23" - `item.tax.value` (number) Example: 23 - `item.retention` (number) Example: 2 ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 404 fields (application/json): - `errors` (array) Example: [{"error":"Resource not found"}] - `errors.error` (string) ## Response 422 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string) ## Response 500 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)