<!-- Generated by scripts/generate_endpoint_docs.py — do not edit by hand. -->
# `api.lots.update`

> `PUT /Lot/{id}` — Catalog

**Python**

```python
api.lots.update(lot_id: int, *, data: UpdateLotRequest | dict) -> LotDto
```

**CLI**

```bash
ab lots update <lot_id> [--data ...]
```

PUT /Lot/{id}.

Args:
    lot_id: Lot identifier.
    data: Lot update payload with ``customer_item_id``,
        ``image_links``, ``overriden_data``, and ``catalogs``.
        (``initial_data`` is create-only — it cannot be updated
        via PUT.) Accepts an :class:`UpdateLotRequest` instance
        or a dict.

Request model: :class:`UpdateLotRequest`

## Request body — `UpdateLotRequest`

| Field | Type | Required | Description |
|---|---|---|---|
| `customerItemId` | `Optional[str]` | no | Customer item ID |
| `imageLinks` | `Optional[list[str]]` | no | Image URLs attached to the lot |
| `overridenData` | `Optional[list[LotDataDto]]` | no | Per-catalog override data entries |
| `catalogs` | `Optional[list[LotCatalogDto]]` | no | Catalogs this lot belongs to |

## Response

Returns `LotDto`.

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | `int` | yes | Lot ID |
| `customerItemId` | `Optional[str]` | no | Customer item ID |
| `initialData` | `Optional[LotDataDto]` | no | Initial lot data |
| `overridenData` | `Optional[list[LotDataDto]]` | no | Override entries |
| `catalogs` | `Optional[list[LotCatalogDto]]` | no | Catalog associations (each entry is a LotCatalogDto) |
| `imageLinks` | `Optional[list[ImageLinkDto]]` | no | Attached image links |

---

[← Back to api.lots](../lots.md)