# Import / Export

## User Perspective
The Import/Export page (`/io`) allows migrating video metadata in bulk.

### CSV Import
1. Upload a CSV file
2. Map CSV columns to video fields (title, tags, description, etc.)
3. Review the validation report — shows errors and warnings per row
4. Commit to apply changes

### JSON Workspace Import
Import a full workspace export (blocks, templates, variables, collaborators) from another team or environment.

### Export
Export video metadata or workspace configuration as CSV or JSON.

## Developer Perspective

### Backend
- **Imports module**: `backend/src/modules/imports/`
  - `POST /imports/csv/preview` — validates CSV, creates `ImportJob` with `validationReport`
  - `POST /imports/csv/commit` — applies the import
  - `POST /imports/json/preview` — validates JSON workspace payload
  - `POST /imports/json/commit` — applies the workspace import
- **Exports module**: `backend/src/modules/exports/`

### Data Models
- `ImportJob` — tracks import with validation report and commit status
- `ExportJob` — tracks export with file reference

## Related
- [[13 - Import Export API]]