## Update a copy

`PUT https://getkollek.com/api/items/{item}/copies/{copy}`

Update the identifier, condition, location, status and estimated value of a copy.

**Permissions:** Owners and editors. Viewers get a 404 response.

### Path parameters

- `item` (integer, required): The ID of the item the copy belongs to.
- `copy` (integer, required): The ID of the copy.

### Body parameters

- `identifier` (string, optional): A reference of your own for this copy, such as a serial or a shelf number.
- `item_condition_id` (integer, optional): The ID of the condition of the copy. Must be a condition of your account.
- `location_id` (integer, optional): The ID of the location where the copy is stored. Must be a location of your account.
- `status` (string, optional): Where the copy sits in its lifecycle. One of owned, ordered, loaned, sold, gifted, lost, stolen, disposed or other. Defaults to owned.
- `quantity` (integer, optional): How many identical units this copy stands for. At least 1, and defaults to 1.
- `disposed_at` (string, optional): The date the copy left the collection, in YYYY-MM-DD format.
- `note` (string, optional): A free form note about the copy.
- `estimated_value` (integer, optional): What the copy is currently reckoned to be worth, in the smallest currency unit (e.g. cents). Recorded as a new valuation rather than overwriting the previous one.

**Returns:** The updated copy object.

### Example request

```bash
curl https://getkollek.com/api/items/1/copies/1 \
  -X PUT \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "CP-0042",
    "item_condition_id": "1",
    "location_id": "1",
    "status": "owned",
    "quantity": "1",
    "disposed_at": "2024-01-15",
    "note": "Signed by the artist.",
    "estimated_value": "5000"
}'
```

### Example response

`Status: 200`

```json
{
    "data": {
        "type": "copy",
        "id": "1",
        "attributes": {
            "item_id": "1",
            "identifier": null,
            "item_condition_id": "1",
            "current_location_id": null,
            "status": "owned",
            "quantity": 1,
            "disposed_at": null,
            "note": null,
            "estimated_value": 5000,
            "created_at": 1752537600,
            "updated_at": 1752537600
        },
        "links": {
            "self": "https://getkollek.com/api/items/1/copies/1"
        }
    }
}
```