## Upload an item photo

`POST https://getkollek.com/api/items/{item}/photos`

Upload a photo for an item, as multipart/form-data. The first photo added to an item becomes its main visual.

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

### Path parameters

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

### Body parameters

- `file` (file, required): The image file to upload. Maximum 10 MB.

**Returns:** The created item photo object.

### Example request

```bash
curl https://getkollek.com/api/items/1/photos \
  -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Accept: application/json"
```

### Example response

`Status: 201`

```json
{
    "data": {
        "type": "item_photo",
        "id": "1",
        "attributes": {
            "item_id": "1",
            "filename": "cover.jpg",
            "mime_type": "image/jpeg",
            "size": 204800,
            "is_main": true,
            "position": 1,
            "created_at": 1752537600,
            "updated_at": 1752537600
        },
        "links": {
            "self": "https://getkollek.com/api/items/1/photos/1"
        }
    }
}
```