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.
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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X PATCH "https://example.com/v1/admin/legacy-imports/string/workspaces" \ -H "Content-Type: application/json" \ -d '{ "workspaces": [ { "sourceWorkspaceId": "string", "selected": true } ] }'{ "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}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.
Approve a reviewed legacy import run
Records the approval and optional note against the run so it becomes eligible to start. Platform admins only, and only for a run awaiting review that has at least one selected workspace and no blocking workspace errors; anything else is a conflict.