---
method: PUT
path: /api/devices/:id
auth: jwt
area: devices
---
<!-- source: internal/handlers/devices.go:336 DeviceHandler.UpdateDevice -->

# Update Device

Update a device's information.

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

## Path Parameters

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

## Request Body

| Field       | Type   | Required | Description                        |
| ----------- | ------ | -------- | ---------------------------------- |
| name        | string | No       | Device display name                |
| device_type | string | No       | Device type (kobo, koreader, etc.) |

### Example Request

```json example-request
{
  "device_name": "My Kobo Clara",
  "sync_enabled": true,
  "auto_sync": true,
  "sync_frequency_minutes": 60
}
```

## Response (200 OK)

```json example-response
{
  "device_updated": true,
  "device": {
    "id": "uuid",
    "device_name": "My Kobo Clara",
    "device_type": "kobo",
    "last_sync": null,
    "last_seen": null,
    "sync_enabled": true,
    "auto_sync": true,
    "sync_frequency_minutes": 5,
    "created_at": "2026-02-08T10:00:00Z",
    "auth_token": ""
  }
}
```

## Error Responses

| Code | Description                    |
| ---- | ------------------------------ |
| 400  | Invalid request data           |
| 401  | Invalid or expired token       |
| 403  | Device does not belong to user |
| 404  | Device not found               |