Skip to content

Errors

An error answers with a JSON body {"error": "...", "code": "..."}. A refused upload is not kept and costs nothing.

Status Code When
400 INVALID_REQUEST A field is missing or invalid; error names it.
400 ASSET_URL_INVALID The url is not an https link, or carries a user name or password.
400 ASSET_URL_BLOCKED The url points to a private or reserved address.
401 The API key is missing, wrong, disabled or expired.
403 API_PLAN_REQUIRED The workspace is not on the Creator or Pro plan.
403 STORAGE_LIMIT_REACHED The workspace has used its storage.
404 ASSET_NOT_FOUND No asset with this id in this workspace.
413 FILE_TOO_LARGE The file is larger than 50 MB.
415 UNSUPPORTED_AUDIO_FORMAT The file is not an MP3.
422 ASSET_DOWNLOAD_FAILED The url could not be downloaded: error gives the status it answered, a timeout, or why it could not be reached.
422 AUDIO_UNREADABLE The audio could not be read.
422 AUDIO_TOO_SHORT The audio is shorter than 3 seconds.
422 AUDIO_TOO_LONG The audio is longer than 30 minutes.
429 UPLOAD_RATE_LIMITED The workspace sent 60 uploads in this hour. Wait as Retry-After says. See Upload rate.
429 RATE_LIMITED Too many requests; wait as Retry-After says.