Roll back a legacy import run
Reverses the workspaces an import created, recording who rolled it back and an optional reason. Platform admins only; only completed, failed, or canceled runs may be rolled back, a reason longer than 2,000 characters is rejected, and the rollback is blocked when a target workspace already has accepted restore claims or has been edited past the event version the import activated.
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/rollback" \ -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}Retry a failed or canceled legacy import run
Re-queues the run's remaining work using its existing approval. Platform admins only; the run must be failed or canceled and must still carry an approval, and a bundle that retention cleanup has already claimed or deleted cannot be retried.
Read the aggregated report for a legacy import run
Returns the run summary together with failure counts grouped by code, the unresolved failures with their messages, entity counts by status, archive counts, and imported time totals. Platform admins only.