hosting
POST /v1/migrations/ai-moves/{moveId}/restart
Start this AI Move again from the beginning, as a fresh move.
Authentication
Send an API key as a bearer token. The key must carry the hosting.import.manage permission; a key without it is refused with 403, not 404.
This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.
Try it
Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.
curl -X POST https://api.zinndigital.com/v1/migrations/ai-moves/{moveId}/restart \
-H "Authorization: Bearer zdk_live_…"Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console
Details
Owner row 1107#24. The fresh move keeps the same site, the access already given and the same ticket; this one is cancelled (its unfinished copy is stopped) and points to the new one in restarted_as. Nothing at the old host is changed. Refused with 409 once the move is done or cancelled (refusal.aiMove.finished), once its switch-over has started (refusal.aiMove.switchStarted), or when its access was already deleted (refusal.aiMove.accessGone — start a new move instead). Requires hosting.import.manage.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
moveId (path) | string | Yes | — |
Response
| Name | Type | Required | What it is |
|---|---|---|---|
id | string | Yes | — |
org_id | string | Yes | — |
site_id | object | No | — |
target_domain | string | Yes | — |
product_line | string | No | — |
stage | string<received, checking_access, needs_access, checking_fit, needs_upgrade, ready_to_copy, copying, verifying, awaiting_cutover, done, needs_staff, cancelled> | Yes | — |
paused | boolean | Yes | — |
taken_over | boolean | Yes | A person from our migration team has taken it over. |
platform | string | Yes | — |
source_urls | string[] | Yes | — |
access_kinds | string[] | Yes | — |
access_report | object | No | Per access kind, ok or the refusal code of the last check. |
route | string | No | The route chosen (ssh, cpanel, plesk, directadmin, ftp). |
inventory | object | No | — |
fit | object | No | The plan-fit verdict and any upgrade offered (engine-quoted). |
approx_size | string | No | — |
move_items | string[] | No | — |
cutover_window | string | No | — |
timezone | string | No | — |
ticket_id | object | No | — |
migration_job_id | object | No | The site migration this move started (copying onwards); its rollback state is on GET /v1/sites/{site_id}/migrations. |
checks | object | No | The switch-over verdict: preview, app, passed (both), then live after the switch-over. |
go_at | object | No | When the GO was given. |
needs | string<, access, mailboxes, replace, replace_existing, address_in_use> | No | What a waiting move is asking the customer for. replace_existing: the domain is already on another site of this organisation (existing_site) — confirm with replace_site_id… |
existing_site | object | No | When needs is replace_existing: the site in this organisation that already holds the domain. |
preview_url | string | No | The preview address, while waiting to switch over. |
extra_purchase_id | object | No | — |
started_by_staff | boolean | No | — |
created_at | object | Yes | — |
updated_at | object | No | — |
completed_at | object | No | — |
progress | AiMoveProgress | Yes | Where the move has got (owner row 1105#11). step of steps on the customer's path (a waiting stage sits on the step it waits in); phase of the copy; files, databases,… |
health | AiMoveHealth | No | The honest state beside the stage (owner row 1107#24). on_track: inside the time the stage normally takes. slow: past it, still working. self_healing: our AI hit a problem… |
restarted_as | object | No | When the customer restarted this move: the fresh move that replaced it. |
can_restart | boolean | No | Whether POST .../restart would start a fresh move now. |
Errors this endpoint can return
401 · 404 · 409