---
method: DELETE
path: /api/devices/:id/shelves
auth: jwt
area: devices
---
<!-- source: internal/handlers/media.go:384 MediaHandler.RemoveFromShelf -->

# Remove from Shelf

Remove a media item from a device's shelf.

**Endpoint**: `DELETE /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 remove from shelf |

### Example Request

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

## Response (200 OK)

```json example-response
{
  "status": "success",
  "message": "book removed from shelf"
}
```

## Error Responses

| Code | Description                    |
| ---- | ------------------------------ |
| 400  | Invalid request data           |
| 401  | Invalid or expired token       |
| 404  | Device or shelf item not found |