API ReferenceEndpointsTransfers
Import another organization's export into this one (admin of both)
Moves a project between organizations without a download: the caller must be an admin of the export's organization (by current membership) and of the organization its token names, where the project is recreated. A new project is created unless target.project_uuid names an empty one; its secret is shown in this response only. Cohorts and boards get new ids with their references remapped, the caller becomes their author, and events keep their timestamps.
Authorization
bearerAuth AuthorizationBearer <token>
Session token issued by the accounts service (or the legacy /v1/auth routes).
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/imports" \ -H "Content-Type: application/json" \ -d '{ "export_uuid": "7a9b0c1d-2e3f-4a5b-8c6d-7e8f9a0b1c2d", "source_organization_uuid": "0b7e2b1a-0a1b-4c2d-8e3f-4a5b6c7d8e9f", "target": { "project_name": "Mobile app" } }'{ "notice": "store the project secret now; it is not shown again", "project": { "created_at": "2026-09-13T12:30:45Z", "data_residency": "US", "key": "3142566d8c88721d6d34bd9443d556bf", "name": "Mobile app", "organization_uuid": "0b7e2b1a-0a1b-4c2d-8e3f-4a5b6c7d8e9f", "secret": "ps_9c0f…", "selected": true, "status_uuid": "9d3f1e2c-5a6b-4c7d-8e9f-0a1b2c3d4e5f", "updated_at": "2026-09-13T12:30:45Z", "uuid": "5f1c2e7a-1c2d-4b3e-9f10-1a2b3c4d5e6f" }, "project_created": true, "transfer": { "bundle_bytes": 0, "bundle_deleted": false, "created_at": "2026-09-13T12:30:45Z", "created_by": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f", "kind": "import", "options": { "include_events": true }, "organization_uuid": "0b7e2b1a-0a1b-4c2d-8e3f-4a5b6c7d8e9f", "progress": { "boards": 3, "cohorts": 2, "event_part_rows": 0, "event_parts_done": 0, "events_done": 450000, "events_total": 1200000, "phase": "events", "users_done": 8000, "users_total": 8000 }, "project_uuid": "5f1c2e7a-1c2d-4b3e-9f10-1a2b3c4d5e6f", "started_at": "2026-09-13T12:30:45Z", "status": "queued", "updated_at": "2026-09-13T12:30:45Z", "uuid": "7a9b0c1d-2e3f-4a5b-8c6d-7e8f9a0b1c2d" }}