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

POST

One-time backfill converting stored file paths from cwd-relative to STORAGE_DIR-relative. Detached run — returns 202 with a jobId; poll /api/admin/import-progress/{jobId}. Run with dryRun first and check missing: rows whose file cannot be found are left untouched rather than rewritten to a plausible-looking wrong value. Idempotent. Owner/admin only.

Request

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

Run started

Bodyapplication/json

🟠403Forbidden

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/admin/maintenance/migrate-storage-paths' \
--header 'Content-Type: application/json' \
--data '{
    "dryRun": false
}'

Response Example

{
    "jobId": "9d222c6d-893e-4e79-8201-3c9ca16a0f39",
    "dryRun": true,
    "cwd": "string",
    "storageDir": "string"
}

Modified at 2026-09-08 18:05:01

/api/admin/tracks/{id}/tags

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