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. |