# Enrichment

External metadata enrichment

## Endpoints

### POST /api/v1/media/enrich/batch

**Authentication:** Required (Bearer JWT)

#### Request Body

`Content-Type: application/json`

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

#### Responses

| Status | Description              |
| ------ | ------------------------ |
| 200    | Enrichment job submitted |
| 400    | Bad request              |
| 401    | Unauthorized             |
| 403    | Forbidden                |
| 500    | Internal server error    |

---

### POST /api/v1/media/{id}/enrich

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In   | Required | Description   |
| ---- | ---- | -------- | ------------- |
| `id` | path | Yes      | Media item ID |

#### Responses

| Status | Description              |
| ------ | ------------------------ |
| 200    | Enrichment job submitted |
| 401    | Unauthorized             |
| 403    | Forbidden                |
| 404    | Not found                |
| 500    | Internal server error    |

---

### GET /api/v1/media/{id}/metadata/external

**Authentication:** Required (Bearer JWT)

#### Parameters

| Name | In   | Required | Description   |
| ---- | ---- | -------- | ------------- |
| `id` | path | Yes      | Media item ID |

#### Responses

| Status | Description           |
| ------ | --------------------- |
| 200    | External metadata     |
| 401    | Unauthorized          |
| 404    | Not found             |
| 500    | Internal server error |

---