---
method: PUT
path: /api/devices/:id/collections/:collectionId
auth: jwt
area: devices
---
<!-- source: internal/handlers/collections.go:724 CollectionHandler.UpdateDeviceMapping -->

# Update Device Collection Mapping

Updates a device shelf-to-collection mapping's shelf name and sync direction.

## Example request

```json example-request
{
  "device_shelf_name": "Kobo",
  "sync_direction": "bidirectional"
}
```

## Example response

```json example-response
{
  "id": "660e8400-e29b-41d4-a716-446655440000",
  "collection_id": "770e8400-e29b-41d4-a716-446655440000",
  "device_id": "550e8400-e29b-41d4-a716-446655440000",
  "device_shelf_name": "Kobo",
  "sync_direction": "bidirectional",
  "created_at": "2026-10-24 13:57:01.81234 +0000 UTC"
}
```

## Request fields

| Field | Type | Required | Notes |
| ----- | ---- | -------- | ----- |
| device_shelf_name | string | yes | |
| sync_direction | string | yes | one of `bidirectional`, `book_to_device`, `device_to_book`, `none` |

## Errors

| Status | Body | When |
| ------ | ---- | ---- |
| 400 | `{"error": "invalid mapping id"}` / `{"error": "invalid request"}` | malformed id or body |
| 500 | `{"error": "..."}` | unexpected server error |