/api/admin/albums/{id}/tracks/import-onedrive-zip

POST

Import an album ZIP shared on OneDrive as local tracks — asynchronous. Validates and returns 202 immediately; the work (download, extract, tag-parse into the upload staging area) runs detached and is observed via GET /api/admin/import-progress/{importId}, whose terminal "done" state carries the tracks/upload response shape.

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

Import started — poll /api/admin/import-progress/{importId}

Bodyapplication/json

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/admin/albums//tracks/import-onedrive-zip' \
--header 'Content-Type: application/json' \
--data '{
    "zipShareUrl": "string",
    "importId": "84402506-7f34-4409-8ec1-a4e0ffb6b608",
    "sessionId": "f6567dd8-e069-418e-8893-7d22fcf12459"
}'

Response Example

{
    "importId": "84402506-7f34-4409-8ec1-a4e0ffb6b608"
}

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

/api/admin/albums/{id}/tracks/upload-zip

/api/admin/import-progress/{importId}