Export & Import

CortexDB supports full data export and import for backups, migrations, and data portability.

Export

Export all episodes for a tenant:

# Export via CLI
cortexdb-cli export \
  --tenant-id my-app \
  --output episodes.ndjson

# Export via API
curl https://api.cortexdb.io/v1/admin/export \
  -H "Authorization: Bearer your-api-key" \
  -G -d "tenant_id=my-app" \
  -o episodes.ndjson

Export with Filters

# Export only decisions
cortexdb-cli export \
  --tenant-id my-app \
  --episode-type decision \
  --output decisions.ndjson

# Export a date range
cortexdb-cli export \
  --tenant-id my-app \
  --after 2026-01-01 \
  --before 2026-03-31 \
  --output q1-2026.ndjson

Import

Import episodes from an exported file:

# Import via CLI
cortexdb-cli import \
  --tenant-id my-app \
  --input episodes.ndjson

# Import via API
curl -X POST https://api.cortexdb.io/v1/admin/import \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/x-ndjson" \
  -d @episodes.ndjson

Import automatically processes imported episodes through the standard ingestion pipeline, including entity extraction and indexing.

Migration Between Instances

# Export from source
cortexdb-cli export --tenant-id my-app --output backup.ndjson \
  --base-url http://source-cortexdb:8080

# Import to destination
cortexdb-cli import --tenant-id my-app --input backup.ndjson \
  --base-url http://dest-cortexdb:8080