Skip to content
How to install

Site imports

Bring an existing WordPress site in: create an import, install its plugin on the old site, then start it. The last two endpoints are the plugin’s own.

Reading needs Read only and changes need Manage, unless an endpoint says otherwise. How to read this page.

List the imports, newest first, with their status and progress.

  • Level: Read only
  • Returns: {items: ImportSummaryDto[]}

Start an import: the old site connects with the plugin it hands out.

  • Level: Manage
  • Input: {sourceUrl?, allowHttp?: false}
  • Returns: 201 ImportDto

One import in full: the old site’s report, its warnings and what Confirm starts with.

  • Level: Manage. It quotes the settings in the old site’s wp-config.php
  • Returns: ImportDto

Download the import’s migration plugin, to install on the old site.

A zip file: the plugin with this import’s connection file in it.

  • Level: Manage. It holds the token that lets whoever has it pull the old site
  • Notes: Not over MCP
  • Returns: application/zip

The panel address and connection code, for the plugin’s form when it came without its connection file.

  • Level: Manage. The code is the token that lets whoever has it pull the old site
  • Notes: Not over MCP
  • Returns: ImportConnectionCodeDto

Start pulling the site, with the choices of the Confirm step.

  • Level: Manage
  • Notes: Job
  • Input: {title, slug, serverId?, phpVersion?, carryConstants?, deactivatePlugins?, removeDropins?, removeMuPlugins?, rewritePaths?: true}

Go on with a stopped import: the pull from where it stopped, or the set-up.

  • Level: Manage
  • Notes: Job

Pull a finished import’s database and changed files again, with the old site in maintenance.

  • Level: Manage
  • Notes: Job · Destructive

Stop the old site’s plugin answering this import.

  • Level: Manage
  • Returns: ImportDto

Delete an import that is not running; the site it made stays.

  • Level: Manage
  • Notes: Destructive
  • Returns: 204

The plugin reports the old site; its import’s token goes in X-WPL7-Import-Token.

  • Level: No key
  • Notes: Not over MCP
  • Input: the report (docs/internal/import-protocol.md)

The plugin reads the import’s progress, with the same header.

  • Level: No key
  • Notes: Not over MCP
  • Returns: MigrateStatusDto