CorefinityCorefinityDocs
Open the Control PanelControl Panel
Files · 1 of 3

corestack_files_sync

Sync an archive into the site.

Scope writeAlso destructive to reveal secretsAsks you to confirmRuns as a taskNo secrets returned
On this page

When to use it

Unpack an uploaded archive (tar, tar.gz, tar.zst or zip; corestack_transfer_upload_create) into a path under the site root (htdocs, a path under it, or shared/…) as the site user. Everything is checked and staged before the site is touched; the platform's own files (wp-config.php, .env, app/etc/env.php, the WordPress loader) are never overwritten or deleted. delete_extraneous removes files the archive does not have, except paths an exclude matches. On a Git-mode site switch to manual deployment first (corestack_deployments_mode_set).

Ask for it

Prompt
Using the Corefinity MCP server, call corestack_files_sync with site_id 4211, transfer_id 2207, target_path /var/www/example.co.uk/htdocs. (Sync an archive into the site.) Tell me what it returned.

Inputs

confirm_domainstringConfirmation

The site's domain, typed exactly, to delete on production. Up to 253 characters.

delete_extraneousboolean

Defaults to false.

excludesarray of strings

rsync patterns: never written, never deleted. Up to 100 items.

site_idintegerRequired

At least 1.

strip_componentsinteger

Defaults to 0. 0 to 5.

target_pathstringRequired

Relative to the site root, e.g. htdocs. Up to 1,024 characters.

transfer_idintegerRequired

At least 1.

Your assistant fills in a confirmation only after you agree.

Example call

tools/call
{
  "name": "corestack_files_sync",
  "arguments": {
    "site_id": 4211,
    "transfer_id": 2207,
    "target_path": "/var/www/example.co.uk/htdocs"
  }
}

If it is refused

ReasonWhat to do
git_modeA files sync into the releases layout of a Git-mode row; switch the site to manual deployment first (corestack_deployments_mode_set).
archive_member_refusedAn archive member's name, type or link target is refused; details names the member; nothing written; repack without it.
archive_too_largeThe archive's entries or expanded bytes are over mcp.files.max_entries / mcp.files.max_expanded_bytes; split the archive.
format_unsupportedThe archive is not tar, tar.gz, tar.zst or zip, a zip uses zip64, encryption or a method other than stored / deflate, or the helper's PHP module would not load in the no-php.ini run — ended at its first step, nothing downloaded or written; repack it.
insufficient_spaceThe row's disk cannot hold the files sync's expanded tree, or a path database export would take the volume's free space under mcp.files.space_margin_bytes; free space or raise the package.
transfer_changedThe transfer's object is not the generation recorded for it, or yields more bytes than its scan did; nothing was written; upload again.
unsafe_linkThe destination holds a symlink the sync would write through that is not one of the row's shared-path links; details names it; nothing written; remove or replace the link, then call again.
transfer_cancelledA consuming run was stopped — or stopped itself at its last check before anything destructive — because the transfer it was using was cancelled, whichever grant ran it; an import's safety snapshot is its way back, a sync's stage is removed; upload the file again if it is still wanted.
managed_elsewhereAnother control panel manages this site, so use that control panel for it. This is refused before anything else about the site, as in the Control Panel and the API. Nothing was done.
invalid_argumentsThe arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again.
tenant_mismatchThe object does not exist or the token may not see it. Check the id.
scope_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
pin_refusedThe grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it.
rate_limitedToo many calls. Wait for the number of seconds the answer names.
temporarily_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
internal_errorSomething went wrong on our side. Quote the trace id to support.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT