---
method: PUT
path: /api/devices/:id/file-aliases/:aliasId
auth: jwt
area: book-matching
---
<!-- source: internal/handlers/matching.go:221 MatchingHandler.UpdateDeviceFileAlias -->

# Update Device File Alias

Update an existing device file alias.

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

## Path Parameters

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

## Request Body

| Field     | Type   | Required | Description   |
| --------- | ------ | -------- | ------------- |
| file_name | string | No       | New file name |
| file_hash | string | No       | New file hash |

### Example Request

```json example-request
{
  "file_name": "updated-book.epub",
  "file_hash": "newhash123..."
}
```

## Response (200 OK)

```json example-response
{
  "id": "uuid",
  "media_item_id": "book-uuid",
  "confidence_score": null,
  "file_path": null,
  "file_sha256": null,
  "last_seen_at": null
}
```

## Error Responses

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