## Move a copy

`POST https://getkollek.com/api/copies/{copy}/location-history`

Move a copy to a location. This closes the copy's open record, opens a new one and updates its current location in one step, so the copy and its history never disagree about where it is.

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

### Path parameters

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

### Body parameters

- `location_id` (integer, required): The ID of the location the copy is moving to. Must be a location of your account.
- `moved_at` (string, required): The date the copy arrived at the location, in YYYY-MM-DD format.
- `reason` (string, optional): Why the copy was moved.
- `note` (string, optional): A free form note about the move.

**Returns:** The new open location history record.

### Example request

```bash
curl https://getkollek.com/api/copies/1/location-history \
  -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "4",
    "moved_at": "2024-01-01",
    "reason": "Rotated into the display case",
    "note": "Front row, eye level."
}'
```

### Example response

`Status: 201`

```json
{
    "data": {
        "type": "location_history",
        "id": "1",
        "attributes": {
            "copy_id": "1",
            "location_id": "4",
            "moved_at": 1704067200,
            "moved_out_at": null,
            "reason": "Rotated into the display case",
            "note": null,
            "is_open": true,
            "created_at": 1752537600,
            "updated_at": 1752537600
        },
        "links": {
            "self": "https://getkollek.com/api/copies/1/location-history/1"
        }
    }
}
```