hosting

POST `/v1/migrations/agent`

Ask the AI migration agent to move a site, in words.

Аутентификација

Пошаљите API кључ као bearer токен. Кључ мора имати дозволу sites.view; кључ без ње се одбија уз 403, а не 404.

Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X POST https://api.zinndigital.com/v1/migrations/agent \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "message": <string> }'

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

The conversational door onto the migration toolchain. Say what you want — "move my site from oldhost.example.com" — and the agent finds the site, works out which control panel the old host runs, plans the move, starts it when you say yes, watches it, and tells you what the comparison of the two sites found. Requires sites.view to ask. What the agent can actually do is decided per tool against your own permissions: a read-only member gets an assistant that explains a migration and cannot start one, and only a member with hosting.backup.manage is offered a rollback. The agent holds no identity of its own. confirm is the list of actions you have approved for this message — migration_start, migration_start_new_site (create the site here and move yours onto it, when you have none yet), migration_cancel or migration_rollback. The platform checks it against what you actually sent, so the assistant cannot start, stop or undo anything by claiming you agreed. credentials carries the login for your old host; it is used for this request and is never stored on the conversation, never returned, and never shown to the model.

Тело захтева

Назив	Тип	Обавезно	Шта је ово
`message`	`string`	Да	What you want, in your own words.
`conversation_id`	`string`	Не	Continue an existing thread. Omit to start a new one.
`site_id`	`string`	Не	The site this thread is about, when you already know it.
`confirm`	`string<migration_start, migration_start_new_site, migration_cancel, migration_rollback>[]`	Не	The actions you approve for this message, by name. The assistant cannot act on anything that is not in this list, however it words its own request — the platform compares its…
`credentials`	`object`	Не	The login for your old host, in the same shape `POST /v1/sites/{siteId}/migrations` takes. Used for this request only: it is never stored on the conversation, never returned by…

Одговор

Назив	Тип	Обавезно	Шта је ово
`conversation`	`MigrationAgentConversation`	Да	—
`turns`	`MigrationAgentTurn[]`	Да	Both turns of this exchange — what you asked and what it answered.
`failure`	`object`	Не	Present only when the assistant itself could not be reached. It says which kind of failure it was, so you are told whether an AI provider is having an outage, whether your own API…

Грешке које ова крајња тачка може вратити

401 · 403 · 404 · 422 · 429

POST /v1/migrations/agent