Library

Get an upload

GET
https://api.tunio.ai/v1/library/uploads/{upload_id}

Get the state of a library upload. Once completed, track_id (music) or jingle_id (jingle) is the new item of the caller's library.

Path parameters

NameTypeDescription
upload_idRequiredstringUpload ID

Responses

NameTypeDescription
successboolean
Always true.
uploadobject
The upload.
completed_atstring
When it completed or failed.
created_atstring
When the upload was accepted.
durationinteger
Length in seconds, set once completed.
errorstring
Machine-readable failure code, set only when state is failed: url_not_allowed, download_failed, file_too_large, not_audio (not an audio file of a supported format), duration_out_of_range, storage_limit_exceeded, processing_failed or processing_timeout.
file_namestring
Name of the sent file, or the last segment of the link.
jingle_idstring
Jingle: the jingle in the caller's library, set once completed; add it to a bundle with POST /v1/jingle-bundles/{bundle_id}/items.
kindstring
music or jingle.
size_bytesinteger
Size of the source file in bytes, known once it is downloaded.
sourcestring
file (sent in the request) or url (downloaded from a link).
source_urlstring
The link the file is downloaded from; null for file uploads.
statestring
pending (waiting for a worker), downloading, processing (checking and converting), completed or failed.
titlestring
Title given in the request, null when none was.
track_idstring
Music: the track in the caller's library, set once completed; add it to a static playlist with POST /v1/playlists/{playlist_id}/items.
upload_idstring
Upload ID; poll GET /v1/library/uploads/{upload_id} with it.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.