Skip to content
IForevents Docs
IForevents Docs
HomeDashboardGitHubPrivacyTermsSecurityIntroduction
Support and SLA

Import another organization's export into this one (admin of both)

POST
/v1/imports

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"  }}
export_uuid*string
Formatuuid
source_organization_uuid*string
Formatuuid
target?