Data Migration Guide
Migrate data between Gauzy instances or from other platforms.
Exporting Data
API Export
curl -H "Authorization: Bearer $TOKEN" \
https://api.example.com/api/export?entities=Employee,Task,TimeLog \
-o gauzy-export.json
Database Export
pg_dump -h $DB_HOST -U $DB_USER gauzy > gauzy_full_backup.sql
Importing Data
From JSON
curl -X POST -H "Authorization: Bearer $TOKEN" \
-F "file=@gauzy-export.json" \
https://api.example.com/api/import
From Other Platforms
| Platform | Method |
|---|---|
| Hubstaff | Built-in integration sync |
| Upwork | Built-in integration sync |
| Toggl | CSV export → Gauzy import |
| Harvest | CSV export → Gauzy import |
| Custom | Use the REST API |
CSV Import Format
Employees
firstName,lastName,email,startedWorkOn
John,Doe,john@example.com,2024-01-15
Jane,Smith,jane@example.com,2024-02-01
Time Logs
employeeEmail,startedAt,stoppedAt,projectName,taskTitle
john@example.com,2024-01-15T09:00:00Z,2024-01-15T17:00:00Z,Project A,Task 1
Migration Steps
- Export data from source system
- Transform data to match Gauzy format
- Import via API or direct database insert
- Verify data integrity
- Test functionality with migrated data
Related Pages
- Import/Export — import/export guide
- Database Backup — backup strategy