# Create Device File Alias

Create a new file alias for a device.

**Endpoint**: `POST /api/devices/:id/file-aliases`
**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                    |
| file_name     | string        | Yes      | Name of the file                   |
| file_hash     | string        | No       | SHA256 hash of the file (optional) |

### Example Request

```json
{
  "media_item_id": "550e8400-e29b-41d4-a716-446655440001",
  "file_name": "book.epub",
  "file_hash": "abc123..."
}
```

## Response (201 Created)

```json
{
  "id": "uuid",
  "device_id": "device-uuid",
  "media_item_id": "book-uuid",
  "file_name": "book.epub",
  "file_hash": "abc123...",
  "created_at": "2026-02-08T10:00:00Z"
}
```

## Error Responses

| Code | Description                    |
| ---- | ------------------------------ |
| 400  | Invalid request data           |
| 401  | Invalid or expired token       |
| 404  | Device or media item not found |
| 409  | File alias already exists      |
