Docs
Open Lodol
DocumentationIntegrationsAPI

Uploadcare

App · File Storage · 9 actions

Upload files to Uploadcare's CDN and get public links, convert documents, images and videos, resize images, and manage, label and group your files.

Actions

ActionWhat it does
Convert a fileTurn a document, image, video or audio file into another format, such as Word to PDF, PDF to JPG or MOV to MP4.
Create a groupGather several Uploadcare files under one link, with a ZIP download of them all.
Delete a fileDelete a file from Uploadcare.
Get a fileLook up a file on Uploadcare: its link, name, type, size, dimensions and metadata.
List filesList the files in your Uploadcare project, newest first, optionally only those uploaded in a date range.
Resize an imageMake a resized copy of an image, such as a thumbnail or a social-media size, and get its link and the image ready to attach.
Store a fileKeep a temporary file for good, such as one sent through Uploadcare's File Uploader on your website.
Update a file's metadataAdd, change or remove the names and values kept with a file, such as an order number or a customer ID.
Upload a filePut a file on Uploadcare and get its public link to share or embed.

Convert a file

Turn a document, image, video or audio file into another format, such as Word to PDF, PDF to JPG or MOV to MP4. Returns the converted file's link, and the file ready to attach.

Inputs

FilefiletextRequired
The file to convert: upload one, pick a file from an earlier step, or paste a public link or an Uploadcare file ID.
Convert toconvert_totextRequired
The format to make. Converting documents, audio and video needs Uploadcare's Pro plan or free trial; images to JPG, PNG or WebP work on every plan.One of: pdf, docx (Word document (DOCX)), jpg (JPG image), png (PNG image), webp (WebP image), txt (Plain text (TXT)), xlsx (Excel spreadsheet (XLSX)), csv, pptx (PowerPoint (PPTX)), html (Web page (HTML)), and 16 more.
Pagepagenumber
Optional, for a document turned into a JPG or PNG: the page to make an image of. Leave blank for every page, which comes back as a ZIP of images.At least 1.
Save assave_astext
Optional. A name for the new file, such as invoice. Leave blank to keep the original name; the right extension is added.
Delete afterdelete_aftertext
Never keeps the file for good. 1 day makes it temporary: Uploadcare deletes it after a day unless a 'Store a file' step keeps it.One of: never, 1_day (1 day). Default: never.

Outputs

content_typetext
The file's media type, e.g. image/png.
delete_aftertext
never when Uploadcare keeps the file, 1_day when it deletes it a day after upload.
deletedtrue/false
True once the file is deleted.
document_reftext
Reference to the file saved in Lodol, for a later step to attach. Empty when the file is over 200 MB; use url instead.
documentslist
The file saved in Lodol, ready to attach.
duration_secondsnumber
Length in seconds, for a video; empty otherwise.
file_idtext
Uploadcare's ID for the file (a UUID), for other steps.
filenametext
The file's name.
heightnumber
Height in pixels, for an image; empty otherwise.
is_imagetrue/false
True when Uploadcare can process the file as an image.
metadataobject
The names and values kept with the file.
size_bytesnumber
Size of the file in bytes.
source_file_idtext
Uploadcare's ID for the file it was made from.
statustext
Status of the action execution ("success" on success).
storedtrue/false
True when Uploadcare keeps the file for good; false for a temporary file it deletes a day after upload.
uploaded_attext
When the file was uploaded (ISO 8601, UTC).
urltext
The file's public link on Uploadcare's CDN, ready to share, embed or download.
widthnumber
Width in pixels, for an image; empty otherwise.
Example output
{
  "content_type": "application/pdf",
  "delete_after": "never",
  "deleted": false,
  "document_ref": "doc_8f2a6c4e1b3d5f7a9c0e2b4d6f8a0c1e",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_8f2a6c4e1b3d5f7a9c0e2b4d6f8a0c1e",
      "filename": "proposal.pdf",
      "size_bytes": 182406,
      "url": "/actions/core/serve-document/doc_8f2a6c4e1b3d5f7a9c0e2b4d6f8a0c1e"
    }
  ],
  "duration_seconds": null,
  "file_id": "c7d2e1f0-9a8b-4c6d-8e5f-4a3b2c1d0e9f",
  "filename": "proposal.pdf",
  "height": null,
  "is_image": false,
  "metadata": {},
  "size_bytes": 182406,
  "source_file_id": "5e4d3c2b-1a09-4f8e-b7d6-c5b4a3928170",
  "status": "success",
  "stored": true,
  "uploaded_at": "2026-10-03T09:12:44.512730Z",
  "url": "https://a1b2c3d4e5.ucarecd.net/c7d2e1f0-9a8b-4c6d-8e5f-4a3b2c1d0e9f/proposal.pdf",
  "width": null
}

Create a group

Gather several Uploadcare files under one link, with a ZIP download of them all.

Inputs

FilesfileslistRequired
The files to gather, up to 1,000. Pick recent ones, or use files' IDs or links from earlier steps.

Outputs

fileslist
The files, in the order they were given.
files_countnumber
How many files the group holds.
group_idtext
Uploadcare's ID for the group.
statustext
Status of the action execution ("success" on success).
urltext
The group's public link, listing its files.
zip_urltext
A link that downloads every file as one ZIP.
Example output
{
  "files": [
    {
      "file_id": "8a1e4c6f-2b3d-4f5a-9e7c-1d2b3c4d5e6f",
      "filename": "team-photo.jpg",
      "url": "https://a1b2c3d4e5.ucarecd.net/d1d8c4b0-3c3e-473b-b8b5-8f6c83e26787~2/nth/0/"
    },
    {
      "file_id": "3f5c2a9e-6b1d-4e8a-9c7f-2d4b6a8e0c13",
      "filename": "invoice-1042.pdf",
      "url": "https://a1b2c3d4e5.ucarecd.net/d1d8c4b0-3c3e-473b-b8b5-8f6c83e26787~2/nth/1/"
    }
  ],
  "files_count": 2,
  "group_id": "d1d8c4b0-3c3e-473b-b8b5-8f6c83e26787~2",
  "status": "success",
  "url": "https://a1b2c3d4e5.ucarecd.net/d1d8c4b0-3c3e-473b-b8b5-8f6c83e26787~2/",
  "zip_url": "https://a1b2c3d4e5.ucarecd.net/d1d8c4b0-3c3e-473b-b8b5-8f6c83e26787~2/archive/zip/"
}

Delete a file

Delete a file from Uploadcare. Its link stops working; there is no undo.

Inputs

FilefiletextRequired
The file to delete. Pick a recent one, or use a file's ID or link from an earlier step.

Outputs

deletedtrue/false
True once it is gone.
file_idtext
Uploadcare's ID for the file (a UUID), for other steps.
filenametext
The file's name.
statustext
Status of the action execution ("success" on success).
Example output
{
  "deleted": true,
  "file_id": "3f5c2a9e-6b1d-4e8a-9c7f-2d4b6a8e0c13",
  "filename": "invoice-1042.pdf",
  "status": "success"
}

Get a file

Look up a file on Uploadcare: its link, name, type, size, dimensions and metadata.

Inputs

FilefiletextRequired
The file to look up. Pick a recent one, or use a file's ID or link from an earlier step.

Outputs

content_typetext
The file's media type, e.g. image/png.
deletedtrue/false
True once the file is deleted.
duration_secondsnumber
Length in seconds, for a video; empty otherwise.
file_idtext
Uploadcare's ID for the file (a UUID), for other steps.
filenametext
The file's name.
heightnumber
Height in pixels, for an image; empty otherwise.
is_imagetrue/false
True when Uploadcare can process the file as an image.
metadataobject
The names and values kept with the file.
size_bytesnumber
Size of the file in bytes.
statustext
Status of the action execution ("success" on success).
storedtrue/false
True when Uploadcare keeps the file for good; false for a temporary file it deletes a day after upload.
uploaded_attext
When the file was uploaded (ISO 8601, UTC).
urltext
The file's public link on Uploadcare's CDN, ready to share, embed or download.
widthnumber
Width in pixels, for an image; empty otherwise.
Example output
{
  "content_type": "image/jpeg",
  "deleted": false,
  "duration_seconds": null,
  "file_id": "8a1e4c6f-2b3d-4f5a-9e7c-1d2b3c4d5e6f",
  "filename": "team-photo.jpg",
  "height": 1600,
  "is_image": true,
  "metadata": {
    "order": "1042"
  },
  "size_bytes": 1204331,
  "status": "success",
  "stored": true,
  "uploaded_at": "2026-10-03T09:12:44.512730Z",
  "url": "https://a1b2c3d4e5.ucarecd.net/8a1e4c6f-2b3d-4f5a-9e7c-1d2b3c4d5e6f/team-photo.jpg",
  "width": 2400
}

List files

List the files in your Uploadcare project, newest first, optionally only those uploaded in a date range.

Inputs

Showshowtext
Stored files are kept for good; temporary ones are deleted a day after upload.One of: all (All files), stored (Stored files), temporary (Temporary files), deleted (Deleted files). Default: all.
Uploaded afteruploaded_afterdate and time
Optional. Only files uploaded after this moment.
Uploaded beforeuploaded_beforedate and time
Optional. Only files uploaded before this moment.
How manylimitnumber
The most files to list, newest first, up to 1,000.From 1 to 1000. Default: 100.

Outputs

countnumber
How many files came back.
fileslist
The files, newest first.
statustext
Status of the action execution ("success" on success).
Example output
{
  "count": 2,
  "files": [
    {
      "content_type": "image/jpeg",
      "deleted": false,
      "duration_seconds": null,
      "file_id": "8a1e4c6f-2b3d-4f5a-9e7c-1d2b3c4d5e6f",
      "filename": "team-photo.jpg",
      "height": 1600,
      "is_image": true,
      "metadata": {
        "order": "1042"
      },
      "size_bytes": 1204331,
      "stored": true,
      "uploaded_at": "2026-10-03T09:12:44.512730Z",
      "url": "https://a1b2c3d4e5.ucarecd.net/8a1e4c6f-2b3d-4f5a-9e7c-1d2b3c4d5e6f/team-photo.jpg",
      "width": 2400
    },
    {
      "content_type": "application/pdf",
      "deleted": false,
      "duration_seconds": null,
      "file_id": "3f5c2a9e-6b1d-4e8a-9c7f-2d4b6a8e0c13",
      "filename": "invoice-1042.pdf",
      "height": null,
      "is_image": false,
      "metadata": {},
      "size_bytes": 48213,
      "stored": true,
      "uploaded_at": "2026-10-03T09:12:44.512730Z",
      "url": "https://a1b2c3d4e5.ucarecd.net/3f5c2a9e-6b1d-4e8a-9c7f-2d4b6a8e0c13/invoice-1042.pdf",
      "width": null
    }
  ],
  "status": "success"
}

Resize an image

Make a resized copy of an image, such as a thumbnail or a social-media size, and get its link and the image ready to attach.

Inputs

ImageimagetextRequired
The image to resize: upload one, pick an image from an earlier step, or paste a public link or an Uploadcare file ID.
Widthwidthnumber
In pixels, up to 3,000. Leave blank to follow the height and keep the proportions.From 1 to 3000.
Heightheightnumber
In pixels, up to 3,000. Leave blank to follow the width and keep the proportions.From 1 to 3000.
Fitfittext
With both a width and a height: keep the whole image inside that size, or fill it exactly and crop what spills over.One of: fit (Fit inside, keeping proportions), fill (Fill the size, cropping the edges). Default: fit.
Save assave_astext
Optional. A name for the new file, such as invoice. Leave blank to keep the original name; the right extension is added.
Delete afterdelete_aftertext
Never keeps the file for good. 1 day makes it temporary: Uploadcare deletes it after a day unless a 'Store a file' step keeps it.One of: never, 1_day (1 day). Default: never.

Outputs

content_typetext
The file's media type, e.g. image/png.
delete_aftertext
never when Uploadcare keeps the file, 1_day when it deletes it a day after upload.
deletedtrue/false
True once the file is deleted.
document_reftext
Reference to the file saved in Lodol, for a later step to attach. Empty when the file is over 200 MB; use url instead.
documentslist
The file saved in Lodol, ready to attach.
duration_secondsnumber
Length in seconds, for a video; empty otherwise.
file_idtext
Uploadcare's ID for the file (a UUID), for other steps.
filenametext
The file's name.
heightnumber
Height in pixels, for an image; empty otherwise.
is_imagetrue/false
True when Uploadcare can process the file as an image.
metadataobject
The names and values kept with the file.
size_bytesnumber
Size of the file in bytes.
source_file_idtext
Uploadcare's ID for the file it was made from.
statustext
Status of the action execution ("success" on success).
storedtrue/false
True when Uploadcare keeps the file for good; false for a temporary file it deletes a day after upload.
uploaded_attext
When the file was uploaded (ISO 8601, UTC).
urltext
The file's public link on Uploadcare's CDN, ready to share, embed or download.
widthnumber
Width in pixels, for an image; empty otherwise.
Example output
{
  "content_type": "image/jpeg",
  "delete_after": "never",
  "deleted": false,
  "document_ref": "doc_1d3f5a7c9e0b2d4f6a8c0e1b3d5f7a9c",
  "documents": [
    {
      "content_type": "image/jpeg",
      "document_ref": "doc_1d3f5a7c9e0b2d4f6a8c0e1b3d5f7a9c",
      "filename": "team-photo.jpg",
      "size_bytes": 96512,
      "url": "/actions/core/serve-document/doc_1d3f5a7c9e0b2d4f6a8c0e1b3d5f7a9c"
    }
  ],
  "duration_seconds": null,
  "file_id": "b9a8c7d6-e5f4-4a3b-8c2d-1e0f9a8b7c6d",
  "filename": "team-photo.jpg",
  "height": 400,
  "is_image": true,
  "metadata": {},
  "size_bytes": 96512,
  "source_file_id": "8a1e4c6f-2b3d-4f5a-9e7c-1d2b3c4d5e6f",
  "status": "success",
  "stored": true,
  "uploaded_at": "2026-10-03T09:12:44.512730Z",
  "url": "https://a1b2c3d4e5.ucarecd.net/b9a8c7d6-e5f4-4a3b-8c2d-1e0f9a8b7c6d/team-photo.jpg",
  "width": 600
}

Store a file

Keep a temporary file for good, such as one sent through Uploadcare's File Uploader on your website. Uploadcare otherwise deletes it a day after upload.

Inputs

FilefiletextRequired
The file to keep. Pick a recent one, or use a file's ID or link from an earlier step.

Outputs

content_typetext
The file's media type, e.g. image/png.
deletedtrue/false
True once the file is deleted.
duration_secondsnumber
Length in seconds, for a video; empty otherwise.
file_idtext
Uploadcare's ID for the file (a UUID), for other steps.
filenametext
The file's name.
heightnumber
Height in pixels, for an image; empty otherwise.
is_imagetrue/false
True when Uploadcare can process the file as an image.
metadataobject
The names and values kept with the file.
size_bytesnumber
Size of the file in bytes.
statustext
Status of the action execution ("success" on success).
storedtrue/false
True when Uploadcare keeps the file for good; false for a temporary file it deletes a day after upload.
uploaded_attext
When the file was uploaded (ISO 8601, UTC).
urltext
The file's public link on Uploadcare's CDN, ready to share, embed or download.
widthnumber
Width in pixels, for an image; empty otherwise.
Example output
{
  "content_type": "image/jpeg",
  "deleted": false,
  "duration_seconds": null,
  "file_id": "8a1e4c6f-2b3d-4f5a-9e7c-1d2b3c4d5e6f",
  "filename": "team-photo.jpg",
  "height": 1600,
  "is_image": true,
  "metadata": {
    "order": "1042"
  },
  "size_bytes": 1204331,
  "status": "success",
  "stored": true,
  "uploaded_at": "2026-10-03T09:12:44.512730Z",
  "url": "https://a1b2c3d4e5.ucarecd.net/8a1e4c6f-2b3d-4f5a-9e7c-1d2b3c4d5e6f/team-photo.jpg",
  "width": 2400
}

Update a file's metadata

Add, change or remove the names and values kept with a file, such as an order number or a customer ID.

Inputs

FilefiletextRequired
The file to label. Pick a recent one, or use a file's ID or link from an earlier step.
MetadatametadataobjectRequired
Names and values to set. Names you leave out stay as they are; leave a value empty to remove that name. Names use letters, digits, '_', '-', '.' or ':'.

Outputs

file_idtext
Uploadcare's ID for the file (a UUID), for other steps.
filenametext
The file's name.
metadataobject
All the file's metadata after the change.
statustext
Status of the action execution ("success" on success).
urltext
The file's public link on Uploadcare's CDN, ready to share, embed or download.
Example output
{
  "file_id": "8a1e4c6f-2b3d-4f5a-9e7c-1d2b3c4d5e6f",
  "filename": "team-photo.jpg",
  "metadata": {
    "customer": "C-311",
    "order": "1042"
  },
  "status": "success",
  "url": "https://a1b2c3d4e5.ucarecd.net/8a1e4c6f-2b3d-4f5a-9e7c-1d2b3c4d5e6f/team-photo.jpg"
}

Upload a file

Put a file on Uploadcare and get its public link to share or embed. Upload a file, use one from an earlier step, or give a link for Uploadcare to fetch.

Inputs

FilefiletextRequired
The file to upload: upload one, pick a file from an earlier step, or paste a public link.
Save assave_astext
Optional. A name for the new file, such as invoice. Leave blank to keep the original name; the right extension is added.
Delete afterdelete_aftertext
Never keeps the file for good. 1 day makes it temporary: Uploadcare deletes it after a day unless a 'Store a file' step keeps it.One of: never, 1_day (1 day). Default: never.
Metadatametadataobject
Optional names and values to keep with the file, such as an order number. Names use letters, digits, '_', '-', '.' or ':'.

Outputs

content_typetext
The file's media type, e.g. image/png.
delete_aftertext
never when Uploadcare keeps the file, 1_day when it deletes it a day after upload.
deletedtrue/false
True once the file is deleted.
duration_secondsnumber
Length in seconds, for a video; empty otherwise.
file_idtext
Uploadcare's ID for the file (a UUID), for other steps.
filenametext
The file's name.
heightnumber
Height in pixels, for an image; empty otherwise.
is_imagetrue/false
True when Uploadcare can process the file as an image.
metadataobject
The names and values kept with the file.
size_bytesnumber
Size of the file in bytes.
statustext
Status of the action execution ("success" on success).
storedtrue/false
True when Uploadcare keeps the file for good; false for a temporary file it deletes a day after upload.
uploaded_attext
When the file was uploaded (ISO 8601, UTC).
urltext
The file's public link on Uploadcare's CDN, ready to share, embed or download.
widthnumber
Width in pixels, for an image; empty otherwise.
Example output
{
  "content_type": "application/pdf",
  "delete_after": "never",
  "deleted": false,
  "duration_seconds": null,
  "file_id": "3f5c2a9e-6b1d-4e8a-9c7f-2d4b6a8e0c13",
  "filename": "invoice-1042.pdf",
  "height": null,
  "is_image": false,
  "metadata": {},
  "size_bytes": 48213,
  "status": "success",
  "stored": true,
  "uploaded_at": "2026-10-03T09:12:44.512730Z",
  "url": "https://a1b2c3d4e5.ucarecd.net/3f5c2a9e-6b1d-4e8a-9c7f-2d4b6a8e0c13/invoice-1042.pdf",
  "width": null
}

Upload to URL

Previous Page

Upstash

Next Page

On this page

ActionsConvert a fileCreate a groupDelete a fileGet a fileList filesResize an imageStore a fileUpdate a file's metadataUpload a file