> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://uploadcare.com/docs/llms.txt. If the request fails, Upload API returns an error response. Error responses are returned in the form of a JSON object with an error code, an HTTP status code and an error message. The following errors are possible. | Error code | HTTP status code | Error message | | --------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------ | | **Base upload errors:** | | | | `AccessTokenExpiredError` | 401 | Expired token. | | `AccessTokenInvalidError` | 401 | Invalid token. Reason: %s | | `AccountBlockedError` | 403 | Account has been blocked. | | `AccountLimitsExceededError` | 403 | Account has reached its limits. | | `AccountUnpaidError` | 403 | Account has been blocked for non-payment. | | `AutostoreDisabledError` | 403 | Autostore is disabled. | | `BaseViewsError` | 400 | Request processing failed. | | `FileMetadataKeyDuplicatedError` | 400 | File's metadata key `%s` has a duplicate. | | `FileMetadataKeyEmptyError` | 400 | File's metadata key can not be empty. | | `FileMetadataKeyForbiddenError` | 400 | File's metadata key `%s` contains symbols not allowed by the metadata key format. | | `FileMetadataKeyLengthTooBigError` | 400 | Length of file metadata key `%s` can not be more than %d symbols. | | `FileMetadataKeysNumberTooBigError` | 400 | A file can not have more than %d metadata keys. | | `FileMetadataValueEmptyError` | 400 | Value of the file metadata key `%s` can not be empty. | | `FileMetadataValueForbiddenError` | 400 | Value of file metadata key `%s` contains symbols not allowed by the metadata value format. | | `FileMetadataValueLengthTooBigError` | 400 | Value of file metadata's key `%s` can not be more than %d symbols in length. | | `FileSizeLimitExceededError` | 400 | File is too large. | | `MethodNotAllowedError` | 405 | HTTP method %s is not allowed for %s. | | `NullCharactersForbiddenError` | 400 | Null characters are not allowed. | | `OperationsLimitExceededError` | 403 | The operation limit of the token is exhausted. | | `PostRequestParserFailedError` | 400 | HTTP POST request parsing failed. | | `ProjectPublicKeyInvalidError` | 403 | %s is invalid. | | `ProjectPublicKeyRemovedError` | 403 | Project %s is removed. | | `ProjectPublicKeyRequiredError` | 403 | %s is required. | | `RequestFileNumberLimitExceededError` | 400 | The request contains too many files. | | `RequestFiledsNumberLimitExceededError` | 400 | The request contains too many HTTP POST fields. | | `RequestSizeLimitExceededError` | 413 | The size of the request is too large. | | `RequestThrottledError` | 429 | Request was throttled. | | `ScopeForbiddenError` | 403 | `uc.restrictions.scope` does not allow `%s`. | | `SignatureExpirationError` | 403 | Expired signature. | | `SignatureExpirationInvalidError` | 400 | `expire` must be a UNIX timestamp. | | `SignatureExpirationRequiredError` | 400 | `expire` is required. | | `SignatureInvalidError` | 403 | Invalid signature. | | `SignatureRequiredError` | 400 | `signature` is required. | | `UploadAPIError` | 500 | Internal error. | | `UploadFailedError` | 403 | Upload failed. | | **FromURL upload errors:** | | | | `DownloadFileError` | 500 | Failed to download the file. | | `DownloadFileHTTPClientError` | 500 | HTTP client error: %s. | | `DownloadFileHTTPNetworkError` | 500 | HTTP network error: %s. | | `DownloadFileHTTPServerError` | 500 | HTTP server error: %s. | | `DownloadFileHTTPURLValidationError` | 500 | HTTP URL validation error: %s. | | `DownloadFileInternalServerError` | 500 | Internal server error. | | `DownloadFileNotFoundError` | 500 | Downloaded file not found. | | `DownloadFileSizeLimitExceededError` | 500 | Downloaded file is too big: %s > %s. | | `DownloadFileTaskFailedError` | 500 | Download task failed. | | `DownloadFileTimeLimitExceededError` | 500 | Failed to download the file within the allotted time limit of %s seconds. | | `DownloadFileValidationFailedError` | 500 | File validation error: %s | | **File upload errors:** | | | | `FileIdInvalidError` | 400 | file_id is invalid. | | `FileIdNotUniqueError` | 400 | File id must be unique. | | `FileIdRequiredError` | 400 | file_id is required. | | `FileNotFoundError` | 404 | File is not found. | | `FileRequiredError` | 400 | There should be a file. | | `FilesNumberLimitExceededError` | 400 | There are too many files. | | `FilesRequiredError` | 400 | Request does not contain files. | | `InternalRequestForbiddenError` | 403 | Forbidden request. | | `InternalRequestInvalidError` | 400 | Incorrect request. | | `MultipartFileAlreadyUploadedError` | 400 | File is already uploaded. | | `MultipartFileCompletionFailedError` | 400 | Can not complete upload. Wrong parts size? | | `MultipartFileIdRequiredError` | 400 | uuid is required. | | `MultipartFileNotFoundError` | 404 | File is not found. | | `MultipartFileSizeLimitExceededError` | 400 | File size exceeds project limit. | | `MultipartFileSizeTooSmallError` | 400 | File size can not be less than %d bytes. Please use direct upload instead of multipart. | | `MultipartPartSizeInvalidError` | 400 | Multipart Upload Part Size should be an integer. | | `MultipartPartSizeTooBigError` | 400 | Multipart Upload Part Size can not be more than %d bytes. | | `MultipartPartSizeTooSmallError` | 400 | Multipart Upload Part Size can not be less than %d bytes. | | `MultipartSizeInvalidError` | 400 | size should be an integer. | | `MultipartUploadSizeTooLargeError` | 400 | Uploaded size is more than expected. | | `MultipartUploadSizeTooSmallError` | 400 | File size mismatch. Not all parts uploaded? | | `RequestParamRequiredError` | 400 | %s is required. | | `SourceURLRequiredError` | 400 | source_url is required. | | `TokenRequiredError` | 400 | token is required. | | `UUIDInvalidError` | 400 | uuid is invalid. | | `UploadViewsError` | 400 | Upload request processing failed. | | `UploadcareFileIdDuplicatedError` | 400 | UPLOADCARE_FILE_ID is duplicated. You are probably a lottery winner. | | `UploadcareFileIdInvalidError` | 400 | UPLOADCARE_FILE_ID should be a valid UUID. | | `UploadcareFileIdRequiredError` | 400 | UPLOADCARE_FILE_ID is required. | | **File group errors:** | | | | `GroupFileURLParsingFailedError` | 400 | This is not a valid file URL: %s. | | `GroupFilesInvalidError` | 400 | No files\[N] parameters found. | | `GroupFilesNotFoundError` | 400 | Some files not found. | | `GroupIdRequiredError` | 400 | group_id is required. | | `GroupNotFoundError` | 404 | group_id is invalid. | | `GroupViewsError` | 400 | Request to group processing failed. | | **File content validation errors:** | | | | `FileInfectedError` | 400 | The file is infected by %s virus. | | `FileTypeForbiddenError` | 400 | Uploading of these file types is not allowed. | | **URL validation errors:** | | | | `HostnameNotFoundError` | 400 | Host does not exist. | | `URLBlacklistedError` | 400 | Source is blacklisted. | | `URLHostMalformedError` | 400 | URL host is malformed. | | `URLHostPrivateIPForbiddenError` | 400 | Only public IPs are allowed. | | `URLHostRequiredError` | 400 | No URL host supplied. | | `URLParsingFailedError` | 400 | Failed to parse URL. | | `URLRedirectsLimitExceededError` | 400 | Too many redirects. | | `URLSchemeInvalidError` | 400 | Invalid URL scheme. | | `URLSchemeRequiredError` | 400 | No URL scheme supplied. | | `URLValidationError` | 400 | Failed to validate URL. |