CorefinityCorefinityDocs
Open the Control PanelControl Panel
Essentials · 9 of 16

Files and transfers

Read and write a site's files, and move archives and database dumps in and out through signed URLs.

On this page

Small files travel inside a tool call. Archives and database dumps travel through a transfer: a signed URL the assistant uploads to or downloads from with curl.

JobToolScopeSize
Read a filecorestack_file_readread128 KiB a call; page with offset
Write a filecorestack_file_writeexec1 MiB
Upload an archive or dumpcorestack_transfer_upload_createwrite100 GiB
Unpack an uploaded archivecorestack_files_syncwrite2,000,000 entries, 200 GiB unpacked
Import an uploaded dumpcorestack_db_importexec
Download site filescorestack_transfer_download_createread
Export the databasecorestack_db_exportexec

Paths are relative to the site root. A path that resolves outside it is refused with path_outside_site.

Upload

  1. Open an upload

    Call corestack_transfer_upload_create with filename and size_bytes. It answers a transfer_id and a url, shown only once.

  2. Send the file

    Terminal
    curl --fail -X PUT --upload-file site.tar.zst 'UPLOAD_URL'
  3. Use it

    Pass the transfer_id to corestack_files_sync (tar, tar.gz, tar.zst or zip) or corestack_db_import (plain, gzip or zstd SQL).

A file sync never overwrites the platform's own configuration files, such as wp-config.php and .env. A database import takes a safety backup first, always on production.

Download

  1. Pack or export

    Call corestack_transfer_download_create for files, or corestack_db_export for the database. Each answers the download when it is ready within the call, and a task otherwise: see Long-running tasks.

  2. Fetch it

    The result carries a download_url. corestack_transfer_get answers a fresh one.

    Terminal
    curl --fail -C - -o site.tar.zst 'DOWNLOAD_URL'

Lifetimes and quotas

RuleValue
Download URL1 hour
Uploaded or packed fileDeleted after 24 hours
Live transfers per environment20
Live transfer size per organisation500 GiB

Files the Control Panel builds

Log exports and invoice PDFs arrive as Control Panel links. Open them in a browser where you are signed in.

Was this helpful?
Open in ClaudeOpen in ChatGPT