Queue a preflight validation pass for an import run
Moves the run into preflight, resets every workspace row to pending and clears prior warnings and errors, then returns the updated summary; the actual validation is performed asynchronously by the import worker. Platform admins only, and only for runs that are uploaded, reviewed, or canceled — any other status is a conflict.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1/admin/legacy-imports/string/preflight"{ "data": { "id": "string", "bundleObjectKey": "string", "bundleChecksum": "string", "sourceSnapshotTimestamp": "string", "sourceVersion": "string", "converterVersion": "string", "status": "uploaded", "mode": "dry_run", "selectedWorkspaceCount": 0, "sourceCounts": { "property1": 0, "property2": 0 }, "targetCounts": { "property1": 0, "property2": 0 }, "warnings": [ "string" ], "errors": [ "string" ], "approvedAt": "string", "canceledByUserId": "string", "cancellationReason": "string", "rollbackRequestedByUserId": "string", "rollbackReason": "string", "startedAt": "string", "completedAt": "string", "createdAt": "string", "updatedAt": "string", "workspaces": [ { "id": "string", "sourceWorkspaceId": "string", "targetWorkspaceId": "string", "selected": true, "stage": "queued", "lifecycleState": "string", "counts": { "property1": 0, "property2": 0 }, "warnings": [ "string" ], "verification": {}, "rollbackState": "string", "attempt": 0, "lastError": "string" } ] }}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Read a legacy import run summary
Returns the current status, counts, warnings, and errors for one import run. Platform admins only; an unknown run id is reported as not found.
Choose which source workspaces an import run covers
Sets the selected flag on the run's source workspaces and recomputes the selected count. Platform admins only, and only while the run is awaiting review; a selection containing duplicate or unknown source workspace ids is rejected as invalid and editing a run in any other status is a conflict.