Skip to main content
GET
List data migration history
This endpoint returns one row per item that a migration copied, shared or moved, newest first: an assistant, and separately its knowledgebase, its tools, its automation flows and its copied voice. It is the Migration History table of the Data Migration page of your administration panel. Each row says whether Roll back data migration can undo it, and what that would do. The list has the rows whose source and destination users are both users of your platform, deleted users included. It also has the rows of migrations made before List data migrations existed, with run_id set to null.
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. Every administrator sees all the rows of your platform. Rows of the owner’s own account can be rolled back only by the owner and by team members with Allow impersonate owner: for anyone else, can_rollback is false.

Query Parameters

integer
Only the rows of one migration, from Start data migration or List data migrations.
string
Only one type, by its label: Assistant, Phone (Grant), Phone (Transfer), Knowledgebase, Tool, Widget, Dashboard, Automate Flow or Voice. You can also send assistant, phone_number (both kinds of phone rows), knowledgebase, tool, custom_widget, custom_dashboard, automate_flow or voice.
string
Only one status: pending, in_progress, completed, failed or rolled_back. Rows are completed, or rolled_back after a rollback.
integer
Only the rows where this user is the source or the destination.
Only the rows whose source or destination user’s name contains this text, up to 100 characters.
integer
default:"15"
Rows per page, from 1 to 100.
integer
default:"1"
The page number.
Unknown fields are refused.

Response

object[]
The rows of this page, newest first
integer
The current page. The response also has last_page, per_page, total, from, to, first_page_url, last_page_url, next_page_url, prev_page_url, path and links, as in List data migrations

Rate limit

The data migration endpoints count toward the limit of 60 requests per minute for each account that the administration endpoints share. Above it they return 429, and the Retry-After response header tells you how many seconds to wait.

Example: The rows of one migration

Example: The assistants copied to or from one user