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.
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 POST "https://example.com/v1/admin/legacy-imports/string/approve" \ -H "Content-Type: application/json" \ -d '{}'{ "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}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.
Start an approved legacy import run
Marks the run running, clears any pending cancellation, and queues its selected workspaces for the import worker. Platform admins only; the run must already be preflighted and approved, otherwise the request is a conflict.