# Files

Managing files in the e-shop.

## List of uploaded files

 - [GET /api/system/files](https://api.docs.shoptet.com/shoptet-api/openapi/files/getlistofuploadedfiles.md): Retrieves your uploaded files that can be copied in supported endpoints
to entities within e-shop.

## Batch files upload

 - [POST /api/system/files](https://api.docs.shoptet.com/shoptet-api/openapi/files/uploadfiles.md): This endpoint has been only renamed from "File upload" after we created
new synchronous endpoint one file upload. Url and structure is unchanged

Performs file upload asynchronously.

Please note that order of files matter (result of job respects the order
of images in request).


In case of specifying filename, keep in mind that extension is checked
whether it respects file type.


The result can be found in job detail in resultUrl. The result is
formed as normal API response:




{
    "data": {
        "images":[
            {
                "index": 0,
                "md5": "072c1a2005e17dcd3a3cca3d2c769264",
                "name": "kocka.png",
                "created": "2023-01-16T13:19:32+0100",
                "sourceUrl": "https://example.com/image.png"
            }
        ]
    },
    "errors": [
        {
            "errorCode": "file-upload-size-limit",
            "message": "Uploaded file size limit exceeded. Limit is 2 MB.",
            "instance": "data[1]"
        }
    ]
}




In the result's images section, there are successfully uploaded images
with their info and with index field which is order of the image in
the request (0-based indexing).


In the result's errors section, there are errors which occurred during
some images upload and with number in brackets in data[0] in
instance, which is order of the image in the request (0-based
indexing).


See more about Files upload


See how [Asynchronous
requests](https://developers.shoptet.com/asynchronous-requests/) work on
our developer's portal.


Currently maximum of 50 files can be uploaded in one request. Current
filesize limit per file is 2MB.

## File upload

 - [POST /api/system/file](https://api.docs.shoptet.com/shoptet-api/openapi/files/uploadfile.md): This is new endpoint - older asynchronous endpoint has been only renamed
to "Batch files upload" in documentation, url and structure is unchanged

Please, do not use this endpoint for batch file upload!

Performs one file upload synchronously in same way as asynchronous files 
upload.


In the result's image section, there are successfully uploaded image
with current unique name and upload datetime.


See more about Files upload


In case of image upload, response tag is "image", any other file types has response key "file" as here:


IMAGE: JPG, PNG, GIF



{
    "data": {
        "image": {
            "name": "image.jpg",
            "created": "2025-03-31T20:28:55+0200"
        }
    },
    "errors": null
}


ANY OTHER FILE TYPE



{
    "data": {
        "file": {
            "name": "file.pdf",
            "created": "2025-03-31T20:28:55+0200"
        }
    },
    "errors": null
}



Current filesize limit is 2MB.