/api/admin/maintenance/migrate-to-r2

POST

Move a product's local track audio into the Cloudflare R2 bucket. Per track: upload (multipart), HEAD size check, CRC check against the stored crc32 when one is warm, flip the row to sourceType=r2 with the object key in cloudItemRef, and only with deleteLocal unlink the file. Detached run — 202 with a jobId; poll /api/admin/import-progress/{jobId} (phase "migrating", then "deleting" when deleteLocal, then "done" with { scanned, moved, skipped, failed[], bytesUploaded, bytesFreed }). Idempotent and resumable. Admin+ only, non-product-scoped keys. Driven in batches by npm run db:migrate-tracks-to-r2.

Request

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

Run started

Bodyapplication/json

🟠403Forbidden

🟠404Record Not Found

🟠409

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/admin/maintenance/migrate-to-r2' \
--header 'Content-Type: application/json' \
--data '{
    "productSlug": "string",
    "limit": 1,
    "dryRun": false,
    "deleteLocal": false,
    "trackIds": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
}'

Response Example

{
    "jobId": "9d222c6d-893e-4e79-8201-3c9ca16a0f39"
}

Modified at 2026-09-10 00:07:25

/api/admin/maintenance/migrate-storage-paths

/api/admin/albums/{id}/import-onedrive/preview