Start data migration
curl --request POST \
--url https://app.autocalls.ai/api/white-label/data-migration/runs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source_user_id": 123,
"destination_user_id": 123,
"assistant_ids": [
123
],
"phone_number_ids": [
123
],
"knowledgebase_ids": [
123
],
"tool_ids": [
123
],
"widget_ids": [
123
],
"dashboard_slugs": [
"<string>"
],
"flow_ids": [
"<string>"
],
"voice_ids": [
123
],
"assistant_options": {
"include_knowledgebase": true,
"include_custom_tools": true,
"include_postcall_flows": true,
"include_inbound_flows": true,
"voice_handling": "<string>"
}
}
'import requests
url = "https://app.autocalls.ai/api/white-label/data-migration/runs"
payload = {
"source_user_id": 123,
"destination_user_id": 123,
"assistant_ids": [123],
"phone_number_ids": [123],
"knowledgebase_ids": [123],
"tool_ids": [123],
"widget_ids": [123],
"dashboard_slugs": ["<string>"],
"flow_ids": ["<string>"],
"voice_ids": [123],
"assistant_options": {
"include_knowledgebase": True,
"include_custom_tools": True,
"include_postcall_flows": True,
"include_inbound_flows": True,
"voice_handling": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
source_user_id: 123,
destination_user_id: 123,
assistant_ids: [123],
phone_number_ids: [123],
knowledgebase_ids: [123],
tool_ids: [123],
widget_ids: [123],
dashboard_slugs: ['<string>'],
flow_ids: ['<string>'],
voice_ids: [123],
assistant_options: {
include_knowledgebase: true,
include_custom_tools: true,
include_postcall_flows: true,
include_inbound_flows: true,
voice_handling: '<string>'
}
})
};
fetch('https://app.autocalls.ai/api/white-label/data-migration/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.autocalls.ai/api/white-label/data-migration/runs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'source_user_id' => 123,
'destination_user_id' => 123,
'assistant_ids' => [
123
],
'phone_number_ids' => [
123
],
'knowledgebase_ids' => [
123
],
'tool_ids' => [
123
],
'widget_ids' => [
123
],
'dashboard_slugs' => [
'<string>'
],
'flow_ids' => [
'<string>'
],
'voice_ids' => [
123
],
'assistant_options' => [
'include_knowledgebase' => true,
'include_custom_tools' => true,
'include_postcall_flows' => true,
'include_inbound_flows' => true,
'voice_handling' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.autocalls.ai/api/white-label/data-migration/runs"
payload := strings.NewReader("{\n \"source_user_id\": 123,\n \"destination_user_id\": 123,\n \"assistant_ids\": [\n 123\n ],\n \"phone_number_ids\": [\n 123\n ],\n \"knowledgebase_ids\": [\n 123\n ],\n \"tool_ids\": [\n 123\n ],\n \"widget_ids\": [\n 123\n ],\n \"dashboard_slugs\": [\n \"<string>\"\n ],\n \"flow_ids\": [\n \"<string>\"\n ],\n \"voice_ids\": [\n 123\n ],\n \"assistant_options\": {\n \"include_knowledgebase\": true,\n \"include_custom_tools\": true,\n \"include_postcall_flows\": true,\n \"include_inbound_flows\": true,\n \"voice_handling\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.autocalls.ai/api/white-label/data-migration/runs")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"source_user_id\": 123,\n \"destination_user_id\": 123,\n \"assistant_ids\": [\n 123\n ],\n \"phone_number_ids\": [\n 123\n ],\n \"knowledgebase_ids\": [\n 123\n ],\n \"tool_ids\": [\n 123\n ],\n \"widget_ids\": [\n 123\n ],\n \"dashboard_slugs\": [\n \"<string>\"\n ],\n \"flow_ids\": [\n \"<string>\"\n ],\n \"voice_ids\": [\n 123\n ],\n \"assistant_options\": {\n \"include_knowledgebase\": true,\n \"include_custom_tools\": true,\n \"include_postcall_flows\": true,\n \"include_inbound_flows\": true,\n \"voice_handling\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.autocalls.ai/api/white-label/data-migration/runs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"source_user_id\": 123,\n \"destination_user_id\": 123,\n \"assistant_ids\": [\n 123\n ],\n \"phone_number_ids\": [\n 123\n ],\n \"knowledgebase_ids\": [\n 123\n ],\n \"tool_ids\": [\n 123\n ],\n \"widget_ids\": [\n 123\n ],\n \"dashboard_slugs\": [\n \"<string>\"\n ],\n \"flow_ids\": [\n \"<string>\"\n ],\n \"voice_ids\": [\n 123\n ],\n \"assistant_options\": {\n \"include_knowledgebase\": true,\n \"include_custom_tools\": true,\n \"include_postcall_flows\": true,\n \"include_inbound_flows\": true,\n \"voice_handling\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"message": "Migration started.",
"data": {
"id": 55,
"status": "queued",
"channel": "api",
"error": null,
"initiated_by": { "id": 5, "name": "Alex Morgan" },
"source_user": { "id": 12, "name": "Jane Cooper" },
"destination_user": { "id": 34, "name": "John Smith" },
"counts": null,
"succeeded": null,
"failed": null,
"results": [],
"warnings": [],
"not_started": [],
"created_at": "2026-11-03T10:15:00+00:00",
"started_at": null,
"finished_at": null
}
}
{
"message": "Unauthenticated."
}
{
"message": "You are not an administrator."
}
{
"message": "You do not have access to data migration."
}
{
"message": "A migration is already running on your platform. Wait for it to finish, then try again."
}
{
"message": "This migration cannot start.",
"blocking_errors": [
{
"item_type": "assistant",
"item_id": null,
"message": "Destination user has reached their assistants limit (4/5)."
},
{
"item_type": "phone_number",
"item_id": 7,
"message": "Phone number has an active WhatsApp sender. Detach it before migrating."
}
]
}
{
"message": "Choose users of your platform.",
"errors": {
"source_user_id": ["Choose users of your platform."]
}
}
{
"message": "Cannot migrate to the same user.",
"errors": {
"destination_user_id": ["Cannot migrate to the same user."]
}
}
{
"message": "Please select at least one item to migrate.",
"errors": {
"selection": ["Please select at least one item to migrate."]
}
}
{
"message": "Some selected items do not belong to the source user.",
"errors": {
"assistant_ids": ["Some selected items do not belong to the source user."]
}
}
{
"message": "This selection copies more than 100 automations. Split it into smaller migrations.",
"errors": {
"flow_ids": ["This selection copies more than 100 automations. Split it into smaller migrations."]
}
}
{
"message": "The assistant_options.voice_handling field accepts only: reference, clone.",
"errors": {
"assistant_options.voice_handling": ["The assistant_options.voice_handling field accepts only: reference, clone."]
}
}
{
"message": "The tenant_id field is not supported.",
"errors": {
"tenant_id": ["The tenant_id field is not supported."]
}
}
{
"message": "Too Many Attempts."
}
{
"message": "Too many data migration requests on your platform. Try again in 42 seconds."
}
Data Migration
Start data migration
Copy assistants, phone numbers and more from one of your users to another, in the background
POST
/
white-label
/
data-migration
/
runs
Start data migration
curl --request POST \
--url https://app.autocalls.ai/api/white-label/data-migration/runs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source_user_id": 123,
"destination_user_id": 123,
"assistant_ids": [
123
],
"phone_number_ids": [
123
],
"knowledgebase_ids": [
123
],
"tool_ids": [
123
],
"widget_ids": [
123
],
"dashboard_slugs": [
"<string>"
],
"flow_ids": [
"<string>"
],
"voice_ids": [
123
],
"assistant_options": {
"include_knowledgebase": true,
"include_custom_tools": true,
"include_postcall_flows": true,
"include_inbound_flows": true,
"voice_handling": "<string>"
}
}
'import requests
url = "https://app.autocalls.ai/api/white-label/data-migration/runs"
payload = {
"source_user_id": 123,
"destination_user_id": 123,
"assistant_ids": [123],
"phone_number_ids": [123],
"knowledgebase_ids": [123],
"tool_ids": [123],
"widget_ids": [123],
"dashboard_slugs": ["<string>"],
"flow_ids": ["<string>"],
"voice_ids": [123],
"assistant_options": {
"include_knowledgebase": True,
"include_custom_tools": True,
"include_postcall_flows": True,
"include_inbound_flows": True,
"voice_handling": "<string>"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
source_user_id: 123,
destination_user_id: 123,
assistant_ids: [123],
phone_number_ids: [123],
knowledgebase_ids: [123],
tool_ids: [123],
widget_ids: [123],
dashboard_slugs: ['<string>'],
flow_ids: ['<string>'],
voice_ids: [123],
assistant_options: {
include_knowledgebase: true,
include_custom_tools: true,
include_postcall_flows: true,
include_inbound_flows: true,
voice_handling: '<string>'
}
})
};
fetch('https://app.autocalls.ai/api/white-label/data-migration/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.autocalls.ai/api/white-label/data-migration/runs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'source_user_id' => 123,
'destination_user_id' => 123,
'assistant_ids' => [
123
],
'phone_number_ids' => [
123
],
'knowledgebase_ids' => [
123
],
'tool_ids' => [
123
],
'widget_ids' => [
123
],
'dashboard_slugs' => [
'<string>'
],
'flow_ids' => [
'<string>'
],
'voice_ids' => [
123
],
'assistant_options' => [
'include_knowledgebase' => true,
'include_custom_tools' => true,
'include_postcall_flows' => true,
'include_inbound_flows' => true,
'voice_handling' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.autocalls.ai/api/white-label/data-migration/runs"
payload := strings.NewReader("{\n \"source_user_id\": 123,\n \"destination_user_id\": 123,\n \"assistant_ids\": [\n 123\n ],\n \"phone_number_ids\": [\n 123\n ],\n \"knowledgebase_ids\": [\n 123\n ],\n \"tool_ids\": [\n 123\n ],\n \"widget_ids\": [\n 123\n ],\n \"dashboard_slugs\": [\n \"<string>\"\n ],\n \"flow_ids\": [\n \"<string>\"\n ],\n \"voice_ids\": [\n 123\n ],\n \"assistant_options\": {\n \"include_knowledgebase\": true,\n \"include_custom_tools\": true,\n \"include_postcall_flows\": true,\n \"include_inbound_flows\": true,\n \"voice_handling\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.autocalls.ai/api/white-label/data-migration/runs")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"source_user_id\": 123,\n \"destination_user_id\": 123,\n \"assistant_ids\": [\n 123\n ],\n \"phone_number_ids\": [\n 123\n ],\n \"knowledgebase_ids\": [\n 123\n ],\n \"tool_ids\": [\n 123\n ],\n \"widget_ids\": [\n 123\n ],\n \"dashboard_slugs\": [\n \"<string>\"\n ],\n \"flow_ids\": [\n \"<string>\"\n ],\n \"voice_ids\": [\n 123\n ],\n \"assistant_options\": {\n \"include_knowledgebase\": true,\n \"include_custom_tools\": true,\n \"include_postcall_flows\": true,\n \"include_inbound_flows\": true,\n \"voice_handling\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.autocalls.ai/api/white-label/data-migration/runs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"source_user_id\": 123,\n \"destination_user_id\": 123,\n \"assistant_ids\": [\n 123\n ],\n \"phone_number_ids\": [\n 123\n ],\n \"knowledgebase_ids\": [\n 123\n ],\n \"tool_ids\": [\n 123\n ],\n \"widget_ids\": [\n 123\n ],\n \"dashboard_slugs\": [\n \"<string>\"\n ],\n \"flow_ids\": [\n \"<string>\"\n ],\n \"voice_ids\": [\n 123\n ],\n \"assistant_options\": {\n \"include_knowledgebase\": true,\n \"include_custom_tools\": true,\n \"include_postcall_flows\": true,\n \"include_inbound_flows\": true,\n \"voice_handling\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"message": "Migration started.",
"data": {
"id": 55,
"status": "queued",
"channel": "api",
"error": null,
"initiated_by": { "id": 5, "name": "Alex Morgan" },
"source_user": { "id": 12, "name": "Jane Cooper" },
"destination_user": { "id": 34, "name": "John Smith" },
"counts": null,
"succeeded": null,
"failed": null,
"results": [],
"warnings": [],
"not_started": [],
"created_at": "2026-11-03T10:15:00+00:00",
"started_at": null,
"finished_at": null
}
}
{
"message": "Unauthenticated."
}
{
"message": "You are not an administrator."
}
{
"message": "You do not have access to data migration."
}
{
"message": "A migration is already running on your platform. Wait for it to finish, then try again."
}
{
"message": "This migration cannot start.",
"blocking_errors": [
{
"item_type": "assistant",
"item_id": null,
"message": "Destination user has reached their assistants limit (4/5)."
},
{
"item_type": "phone_number",
"item_id": 7,
"message": "Phone number has an active WhatsApp sender. Detach it before migrating."
}
]
}
{
"message": "Choose users of your platform.",
"errors": {
"source_user_id": ["Choose users of your platform."]
}
}
{
"message": "Cannot migrate to the same user.",
"errors": {
"destination_user_id": ["Cannot migrate to the same user."]
}
}
{
"message": "Please select at least one item to migrate.",
"errors": {
"selection": ["Please select at least one item to migrate."]
}
}
{
"message": "Some selected items do not belong to the source user.",
"errors": {
"assistant_ids": ["Some selected items do not belong to the source user."]
}
}
{
"message": "This selection copies more than 100 automations. Split it into smaller migrations.",
"errors": {
"flow_ids": ["This selection copies more than 100 automations. Split it into smaller migrations."]
}
}
{
"message": "The assistant_options.voice_handling field accepts only: reference, clone.",
"errors": {
"assistant_options.voice_handling": ["The assistant_options.voice_handling field accepts only: reference, clone."]
}
}
{
"message": "The tenant_id field is not supported.",
"errors": {
"tenant_id": ["The tenant_id field is not supported."]
}
}
{
"message": "Too Many Attempts."
}
{
"message": "Too many data migration requests on your platform. Try again in 42 seconds."
}
This endpoint starts a migration from one user of your platform to another. It is the Execute Migration button of the Data Migration page of your administration panel, with the same rules. The migration runs in the background: the request returns at once with the migration’s
At least one list must have an item. Unknown fields are refused, and then nothing is started.
id and the status queued, and Get data migration shows its progress and its results.
This endpoint is available to the account owner (with an active plan) and to team members with Platform Admin. Other users receive a 403 Forbidden error. The owner’s own account can be a source or a destination only for the owner and for team members with Allow impersonate owner. Users outside your platform are refused with 422.
How it runs
- Checks. The selection is checked as in Preview data migration: the two users, the IDs, the destination user’s limits for the whole selection, every phone number and the automation flows. If anything would stop the migration part-way, nothing starts and the request returns 422 with the
blocking_errors. You do not need to call the preview first. - One at a time. Your platform runs one migration at a time. While another one is queued or running, the request returns 409: start again when it has finished.
- Queued. Otherwise the migration is recorded and returned with the status
queued. - Checked again. When it starts running, the migration checks your access, the selection and the limits again, because they may have changed while it waited. If something no longer fits, it ends
failed, with the reason inerror, and nothing is copied. - Copying. Items are copied in this order: assistants, phone numbers, knowledgebases, tools, widgets, dashboards, voices, then automation flows. The results are saved after each item. No new item starts after 10 minutes: the items left are listed in
not_started. - Done. The status becomes
completed,completed_with_issuesorfailed, and the administrator who started it gets a notification in the administration panel.
id, for example every few seconds, until the status is no longer queued or running.
What each type does
-
Assistants are copied to the destination user with a new ID. A copy has no phone number unless its number is migrated with it: the number is then attached to the copy, which can take and place calls on it right away. Depending on
assistant_options, the copy also gets:- its knowledgebase and custom tools, copied with it. When they were already copied to this destination user by an earlier migration, that copy is reused;
- its voice, used as it is or copied (
voice_handling); - its greeting audio and its secondary languages;
- the automation flows behind its webhooks, copied as unpublished drafts that start from the new assistant. With the option off, those webhooks are left empty on the copy.
- Normal phone numbers are shared. The source user keeps the number and keeps paying for it, and only the destination user can use it. The access ends with the number’s subscription.
- SIP and Caller ID numbers change owner. The number moves to the destination user, with its trunk settings and caller ID verification, and the source user’s assistants on it are unassigned.
- Knowledgebases are copied, and their documents are processed again in the background. A knowledgebase already copied to this destination user by an earlier migration is reused, without the changes made since.
- Tools are copied, and reused like knowledgebases. The flow behind an automation tool is copied too. When it cannot be copied, the copy’s endpoint is left empty.
- Widgets are copied. A widget that shows one assistant shows its copy when that assistant is migrated in the same migration; otherwise it shows all the destination user’s assistants until it is set up again. Campaign filters are cleared.
- Dashboards are copied with their own copies of their widgets, under a new slug. They do not become the destination user’s default dashboard.
-
Voices are copied as a new voice of the destination user that uses the same provider voice. A voice listed in
voice_idscounts against the destination user’s cloned voices limit. - Automation flows are copied as unpublished drafts. Each step uses the destination user’s connection to the same app: add the missing connections, then publish the flow. A flow copied on its own has its assistant selection cleared.
Automation flows
An automation flow is copied only when it is in the source user’s automation workspace and the destination user has a workspace too:- Behind an assistant’s webhook or a tool’s endpoint, a flow that does not meet these conditions is not copied, and the webhook or endpoint is left empty on the copy, with a warning.
- In
flow_ids, a flow that is not in the source user’s workspace, or a source or destination user without a workspace, blocks the migration with 422. - Each flow is checked before anything is copied, within 60 seconds. A flow that could not be checked in time is not copied, with a warning.
- One migration copies at most 100 automation flows in total, counting those behind the assistants’ webhooks, the tools’ endpoints and
flow_ids. Above that, split the selection into smaller migrations.
Running it again
Each migration copies again: migrating the same assistant, widget, dashboard or flow twice gives two copies. Knowledgebases and tools are the exception: one already copied to the same destination user is reused. A phone number already shared with the destination user, or no longer owned by the source user, is refused.When part of it fails
Each item is copied completely or not at all, but a migration is not: a failed item, or one that did not start, does not undo the others. The migration then endscompleted_with_issues, or failed after an unexpected error. In both cases the results of Get data migration list what was copied, with the history row IDs to undo each item with Roll back data migration.
Request Body
integer
required
The user to copy from, from List data migration users.
integer
required
The user to copy to, from List data migration users. It must be another user than the source.
integer[]
Assistants of the source user, from Get data migration items. Up to 1000.
integer[]
Phone numbers of the source user, from Get data migration items. Up to 1000. A number used by an assistant you migrate is attached to its copy.
integer[]
Knowledgebases to copy on their own. Up to 1000. The knowledgebase of a migrated assistant is copied with it when
include_knowledgebase is on, so you do not need to list it.integer[]
Tools to copy on their own. Up to 1000. The tools of a migrated assistant are copied with it when
include_custom_tools is on.integer[]
Widgets of the source user. Up to 1000.
string[]
Dashboards of the source user, by
slug. Up to 100, each at most 100 characters.string[]
Automation flows of the source user, from List data migration flows. Up to 50. Each ID has only letters, digits,
- and _, and at most 64 characters. Any flow of the source user’s workspace can be sent, also one the listing did not reach.integer[]
The source user’s own voices, to copy on their own. Up to 1000.
object
How the migrated assistants are copied. These options apply to every assistant of the migration.
Show assistant_options properties
Show assistant_options properties
boolean
default:"true"
Copy each assistant’s knowledgebase with it. Off, the copy has no knowledgebase.
boolean
default:"true"
Copy each assistant’s custom tools with it. Off, the copy has no custom tools.
boolean
default:"true"
Copy the automation flows behind the post-call and conversation-ended webhooks. Off, those webhooks are left empty on the copy.
boolean
default:"true"
Copy the automation flows behind the inbound, chat conversation and WhatsApp voice webhooks. Off, those webhooks are left empty on the copy.
string
default:"reference"
reference: the copy uses the source user’s voice. clone: the destination user gets their own copy of the voice. Voices of the platform are always used as they are.Response
string
Migration started.object
The migration, as in Get data migration, with the status
queued. Its counts, succeeded and failed are null and its results empty until it runs{
"message": "Migration started.",
"data": {
"id": 55,
"status": "queued",
"channel": "api",
"error": null,
"initiated_by": { "id": 5, "name": "Alex Morgan" },
"source_user": { "id": 12, "name": "Jane Cooper" },
"destination_user": { "id": 34, "name": "John Smith" },
"counts": null,
"succeeded": null,
"failed": null,
"results": [],
"warnings": [],
"not_started": [],
"created_at": "2026-11-03T10:15:00+00:00",
"started_at": null,
"finished_at": null
}
}
{
"message": "Unauthenticated."
}
{
"message": "You are not an administrator."
}
{
"message": "You do not have access to data migration."
}
{
"message": "A migration is already running on your platform. Wait for it to finish, then try again."
}
{
"message": "This migration cannot start.",
"blocking_errors": [
{
"item_type": "assistant",
"item_id": null,
"message": "Destination user has reached their assistants limit (4/5)."
},
{
"item_type": "phone_number",
"item_id": 7,
"message": "Phone number has an active WhatsApp sender. Detach it before migrating."
}
]
}
{
"message": "Choose users of your platform.",
"errors": {
"source_user_id": ["Choose users of your platform."]
}
}
{
"message": "Cannot migrate to the same user.",
"errors": {
"destination_user_id": ["Cannot migrate to the same user."]
}
}
{
"message": "Please select at least one item to migrate.",
"errors": {
"selection": ["Please select at least one item to migrate."]
}
}
{
"message": "Some selected items do not belong to the source user.",
"errors": {
"assistant_ids": ["Some selected items do not belong to the source user."]
}
}
{
"message": "This selection copies more than 100 automations. Split it into smaller migrations.",
"errors": {
"flow_ids": ["This selection copies more than 100 automations. Split it into smaller migrations."]
}
}
{
"message": "The assistant_options.voice_handling field accepts only: reference, clone.",
"errors": {
"assistant_options.voice_handling": ["The assistant_options.voice_handling field accepts only: reference, clone."]
}
}
{
"message": "The tenant_id field is not supported.",
"errors": {
"tenant_id": ["The tenant_id field is not supported."]
}
}
{
"message": "Too Many Attempts."
}
{
"message": "Too many data migration requests on your platform. Try again in 42 seconds."
}
Rate limit
The data migration endpoints count toward the limit of 60 requests per minute for each account that the administration endpoints share. Starting a migration also has its own limit: 5 per minute for each account, and 5 per minute for your whole platform, counted together for the API, the AI connector and the Data Migration page. Above a limit it returns429, and the Retry-After response header tells you how many seconds to wait.
Example: Copy an assistant with its phone number
curl -X POST https://app.autocalls.ai/api/white-label/data-migration/runs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"source_user_id": 12,
"destination_user_id": 34,
"assistant_ids": [101],
"phone_number_ids": [7],
"assistant_options": {
"voice_handling": "reference"
}
}'
Example: Copy assistants without their automations, with their own voices
curl -X POST https://app.autocalls.ai/api/white-label/data-migration/runs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"source_user_id": 12,
"destination_user_id": 34,
"assistant_ids": [101, 102],
"assistant_options": {
"include_postcall_flows": false,
"include_inbound_flows": false,
"voice_handling": "clone"
}
}'
Example: Copy a dashboard and two automation flows
curl -X POST https://app.autocalls.ai/api/white-label/data-migration/runs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"source_user_id": 12,
"destination_user_id": 34,
"dashboard_slugs": ["sales"],
"flow_ids": ["Ab3xK9pQ2mZ7", "Qw8eR4tY6uI1"]
}'