Dark
Get help in the API Community

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 then 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. For example, it has 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

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