# Search

Full-text media search

## Endpoints

### GET /api/v1/search

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name     | In    | Required | Description       |
| -------- | ----- | -------- | ----------------- |
| `q`      | query | Yes      | Search query      |
| `sort`   | query | No       | Sort order        |
| `offset` | query | No       | Pagination offset |
| `limit`  | query | No       | Pagination limit  |

#### Responses

| Status | Description           |
| ------ | --------------------- |
| 200    | Search results        |
| 400    | Bad request           |
| 401    | Unauthorized          |
| 500    | Internal server error |

---

### POST /api/v1/search

**Authentication:** Required (Bearer JWT)

#### Request Body

`Content-Type: application/json`

See `docs/api/openapi.json` for the full schema.

#### Responses

| Status | Description           |
| ------ | --------------------- |
| 200    | Search results        |
| 400    | Bad request           |
| 401    | Unauthorized          |
| 500    | Internal server error |

---