hosting
PUT /v1/migrations/ai-moves/{moveId}/access
Send fresh access for an AI Move (the secure form).
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 PUT https://api.zinndigital.com/v1/migrations/ai-moves/{moveId}/access \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ }'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
The answer to the ticket's "please send fresh access": written straight to Vault, merged with what was given before, and the move carries on by itself. Never send a password on the ticket. Requires hosting.import.manage.
Parameters
| Name | Type | Required | What it is |
|---|---|---|---|
moveId (path) | string | Yes | — |
Request body
| Name | Type | Required | What it is |
|---|---|---|---|
access | AiMoveAccess | No | At least one of ssh, panel, ftp; database and wp_admin help the checks. |
mailbox_passwords | object | No | Mailbox address -> password. Straight to Vault; never stored or returned. |
replace_confirmation | string | No | The site's domain typed back, to confirm replacing a site that has content. |
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 | — |
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> | No | What a waiting move is asking the customer for. |
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 | — |
Errors this endpoint can return
401 · 404 · 409 · 422 · 503