# Add to Shelf

Add a media item to a device's shelf (Kobo reading shelf).

**Endpoint**: `POST /api/devices/:id/shelves`
**Auth**: Required
**Content-Type**: `application/json`

## Path Parameters

| Parameter | Type          | Required | Description |
| --------- | ------------- | -------- | ----------- |
| id        | string (UUID) | Yes      | Device UUID |

## Request Body

| Field         | Type          | Required | Description                     |
| ------------- | ------------- | -------- | ------------------------------- |
| media_item_id | string (UUID) | Yes      | Media item UUID to add to shelf |

### Example Request

```json
{
  "media_item_id": "550e8400-e29b-41d4-a716-446655440001"
}
```

## Response (201 Created)

```json
{
  "message": "Item added to shelf successfully",
  "device_id": "uuid",
  "media_item_id": "uuid"
}
```

## Error Responses

| Code | Description                    |
| ---- | ------------------------------ |
| 400  | Invalid request data           |
| 401  | Invalid or expired token       |
| 404  | Device or media item not found |
| 409  | Item already on shelf          |
