Errors
"message" field is optional and would be used for additional logging purposes.
In case you don't want to send 403 errors for security or some other reason you can send 404 with no body instead. But in this case users will get vague error message like "Asset not found" instead of the exact reason for the error.
| HTTP Status Code | Body | Description |
|---|---|---|
400 | {"error-code": "file-too-large", "max-file-size-bytes": <your max file size limit in bytes>, "message": <any>} | Returned when passed file size larger than allowed |
400 | {"error-code": "missing-required-parameter", "message": "missing <paramName> parameter"} | Returned when required request parameter missed |
400 | {"error-code": "missing-required-attribute", "message": "missing required attributes", "missing-required-attributes-ids": []} | Returned when required attributes are missing during upload |
400 | {"error-code": "invalid-attribute", "message": "invalid attributes", "invalid-attributes-ids": []} | Returned when invalid attribute values requested during upload |
400 | {"error-code": "malformed-multipart-request", "message": <any>} | Returned for features.upload.create-upload.upload-chunk-url when request is invalid |
400 | {"error-code": "invalid-filename", "message": <any>} | Returned when invalid filename requested during upload (e.g. unsupported symbols) |
400 | {"error-code": "invalid-filetype", "message": <any>} | Returned when invalid file type requested during upload/version upload |
403 | {"error-code": "no-access-to-folder", "message": <any>} | Returned when user has no access to the folder |
403 | {"error-code": "no-right-to-upload-to-folder", "message": <any>} | Returned when user has no right to upload files to the folder |
403 | {"error-code": "no-right-to-upload", "message": <any>} | Returned when user has no right to upload to DAM at all |
403 | {"error-code": "no-access-to-asset", "message": <any>} | Returned when user has no access to asset |
404 | (empty) | Returned when requested resource doesn't exist |
500 | {"error-code": "generic", "message": <any>} | A generic error, given when an unexpected condition was encountered and no more specific message is suitable |
Updated 2 months ago