APIs/For your website

Files API

Images and documents from your dashboard's Storage, folder by folder.

/v1/filesCounts toward your plan's quota1 endpoint

Every file comes with its public address, size and folder, so your website can show a gallery or link a PDF without copying anything.

GET/v1/files

List files

Every file in a project, or in one folder.

Query

projectRequiredinteger	Your project ID, shown in the dashboard.
folderinteger or string	Only this folder: its ID (`7`) or its name (`logos`). We tell which one you sent.

Response

idinteger	File ID
id_folderinteger or null	Folder ID, `null` when the file is in no folder
typestring	MIME type, such as `image/png`
file_extensionstring	Such as `png` or `pdf`
original_namestring	The name it was uploaded with
file_namestring	The name we store it under
titlestring or null	Title set in the dashboard
descriptionstring or null	Description set in the dashboard
urlstring	Public address of the file
size_mbnumber	Size in megabytes
percent_whitenumber	Share of white pixels, images only
privacystring	`public` or `private`
folderobject or null	The folder, `null` when there is none
folder.idinteger	Folder ID
folder.namestring	Folder name
folder.is_galleryinteger	`1` when every file in the folder is an image. It follows what the folder holds

GETapi.calenzy.app/v1/files?project=123

curl "https://api.calenzy.app/v1/files?project=123" \
  -H "Authorization: Bearer YOUR_API_KEY"

GETapi.calenzy.app/v1/files?project=123&folder=7

curl "https://api.calenzy.app/v1/files?project=123&folder=7" \
  -H "Authorization: Bearer YOUR_API_KEY"

GETapi.calenzy.app/v1/files?project=123&folder=logos

curl "https://api.calenzy.app/v1/files?project=123&folder=logos" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response · 200 OK

[
  {
    "id": 26,
    "id_folder": 7,
    "type": "image/png",
    "file_extension": "png",
    "original_name": "logo.png",
    "file_name": "41-18-20260127170830846156.png",
    "title": null,
    "description": null,
    "url": "https://files.calenzy.fr/files/41-18-20260127170830846156.png",
    "size_mb": 0.023026,
    "percent_white": 5,
    "privacy": "public",
    "folder": { "id": 7, "name": "Documents", "is_gallery": 0 }
  },
  {
    "id": 73,
    "id_folder": null,
    "type": "application/pdf",
    "file_extension": "pdf",
    "original_name": "terms.pdf",
    "file_name": "b982064c0950e5b81de1e2af3a1e88d9.pdf",
    "title": null,
    "description": null,
    "url": "https://files.calenzy.fr/files/b982064c0950e5b81de1e2af3a1e88d9.pdf",
    "size_mb": 0.472618,
    "percent_white": 0,
    "privacy": "public",
    "folder": null
  }
]