# Scan

Directory scanning

## Endpoints

### POST /api/v1/scan

Trigger a scan as a background job. Returns the job ID immediately.

**Authentication:** Required (Bearer JWT)

#### Request Body

`Content-Type: application/json`

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

#### Responses

| Status | Description |
|--------|-------------|
| 200 | Scan job submitted |
| 401 | Unauthorized |
| 403 | Forbidden |
| 500 | Internal server error |

---

### GET /api/v1/scan/status

**Authentication:** Required (Bearer JWT)

#### Responses

| Status | Description |
|--------|-------------|
| 200 | Scan status |
| 401 | Unauthorized |

---