---
title: "Cloud Sync"
description: "Sync ZeroDB data between local and cloud — import and export bundles"
canonical: "https://docs.ainative.studio/docs/zerodb/cloud-sync"
last-updated: "2026-10-13T21:42:35.442Z"
---

# Cloud Sync

Source: https://docs.ainative.studio/docs/zerodb/cloud-sync

> Sync ZeroDB data between local and cloud — import and export bundles

## Cloud Sync

Cloud Sync lets you move ZeroDB data between local instances and the cloud, or between projects. Use it for backups, migrations, and offline-first workflows.

## Export a Sync Bundle

Export your project's data as a portable bundle:

```bash
curl -X POST https://api.ainative.studio/api/v1/projects/{project_id}/sync/export \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "include": ["tables", "vectors", "memory", "events"],
    "compress": true
  }'
```

Response includes a `bundle_id` you use to download the bundle.

## Download a Bundle

```bash
curl -O https://api.ainative.studio/api/v1/projects/{project_id}/sync/export/{bundle_id} \
  -H "x-api-key: $API_KEY"
```

## Import a Sync Bundle

```bash
curl -X POST https://api.ainative.studio/api/v1/projects/{project_id}/sync/import \
  -H "x-api-key: $API_KEY" \
  -F "bundle=@./zerodb-backup.zip"
```

## Check Sync State

```bash
curl https://api.ainative.studio/api/v1/projects/{project_id}/sync/state \
  -H "x-api-key: $API_KEY"
```

## List Available Bundles

```bash
curl https://api.ainative.studio/api/v1/projects/{project_id}/sync/bundles \
  -H "x-api-key: $API_KEY"
```

## Python SDK

```python
import requests

API_KEY = "your-api-key"
PROJECT_ID = "your-project-id"
BASE = f"https://api.ainative.studio/api/v1/projects/{PROJECT_ID}/sync"
headers = {"x-api-key": API_KEY}

## Export
r = requests.post(f"{BASE}/export", headers={**headers, "Content-Type": "application/json"}, json={
    "include": ["tables", "vectors", "memory"],
    "compress": True
})
bundle_id = r.json()["bundle_id"]
print(f"Bundle ready: {bundle_id}")

## Download
bundle = requests.get(f"{BASE}/export/{bundle_id}", headers=headers)
with open("backup.zip", "wb") as f:
    f.write(bundle.content)

## Check sync state
state = requests.get(f"{BASE}/state", headers=headers).json()
print(f"Last synced: {state['last_synced_at']}")
```

## Use Cases

- **Local development**: Export prod data, import into local ZeroDB for testing
- **Backups**: Schedule regular exports to keep recoverable snapshots
- **Migration**: Move data between projects or regions
- **Offline-first**: Sync when connectivity is restored after offline agent runs

## Endpoints

| Method | Path | Description |
|--------|------|-------------|
| POST | `/sync/import` | Upload and import a sync bundle |
| GET | `/sync/export/{bundle_id}` | Download a sync bundle |
| GET | `/sync/state` | Get current sync status |
| GET | `/sync/bundles` | List available bundles |