Filestack

App · File Storage · 9 actions

Upload files to Filestack for a permanent public link, convert documents and images, resize and compress images, screenshot web pages, and replace or delete hosted files.

Actions

ActionWhat it does
Compress an imageMake a JPG or PNG image smaller, so it loads faster, without visibly changing it.
Convert a fileConvert a document or image to another format, such as Word to PDF or PDF to JPG.
Delete a filePermanently delete a Filestack file.
Download a fileSave a Filestack file in Lodol, so a later step can attach it to an email or upload it somewhere else.
Get a fileLook up a Filestack file: its name, type, size, link and when it was uploaded.
Replace a fileSwap a Filestack file's contents for a new file.
Resize an imageMake an image a different size, such as a thumbnail or a banner.
Take a screenshot of a web pageCapture a public web page as an image, as it looks on a computer or a phone.
Upload a filePut a file on Filestack and get a public link to share or embed, plus its file ID for the other Filestack steps.

Compress an image

Make a JPG or PNG image smaller, so it loads faster, without visibly changing it. Returns the smaller image and a public link.

Inputs

FilefiletextRequired
The JPG or PNG to compress: upload one, pick one from an earlier step, paste a public link, or give a Filestack file ID. Other formats come back unchanged.
Save assave_astext
Optional. The compressed image's name. Leave blank to add '-compressed' to the original name.

Outputs

content_typetext
The file's media type, e.g. image/png.
document_reftext
The file, saved in Lodol, for a later step to attach or upload.
documentslist
The file saved in Lodol.
file_idtext
The file's Filestack ID, for the other Filestack steps.
filenametext
The file's name.
size_bytesnumber
Size of the file in bytes.
statustext
Status of the action execution ("success" on success).
urltext
The file's public Filestack link, ready to share or embed. It does not expire.
Example output
{
  "content_type": "image/jpeg",
  "document_ref": "doc_5e6f7a8b",
  "documents": [
    {
      "content_type": "image/jpeg",
      "document_ref": "doc_5e6f7a8b",
      "filename": "team-photo-compressed.jpg",
      "size_bytes": 201377,
      "url": "/actions/core/serve-document/doc_5e6f7a8b"
    }
  ],
  "file_id": "Mv4nBx6QPs1dHf3gJkLw",
  "filename": "team-photo-compressed.jpg",
  "size_bytes": 201377,
  "status": "success",
  "url": "https://cdn.filestackcontent.com/Mv4nBx6QPs1dHf3gJkLw"
}

Convert a file

Convert a document or image to another format, such as Word to PDF or PDF to JPG. Returns the converted file and a public link.

Inputs

FilefiletextRequired
The file to convert: upload one, pick one from an earlier step, paste a public link, or give a Filestack file ID.
Convert tooutput_formattextRequired
The format to convert it into.One of: pdf, docx (Word (DOCX)), doc (Word 97-2003 (DOC)), odt (OpenDocument text (ODT)), txt (Plain text (TXT)), html (Web page (HTML)), xlsx (Excel (XLSX)), xls (Excel 97-2003 (XLS)), ods (OpenDocument spreadsheet (ODS)), pptx (PowerPoint (PPTX)), and 7 more. Default: pdf.
Pagepagenumber
When turning a document into an image, which page to use. Leave blank for the first.From 1 to 99999.
Save assave_astext
Optional. The converted file's name. Leave blank to keep the original name with the new extension.

Outputs

content_typetext
The file's media type, e.g. image/png.
document_reftext
The file, saved in Lodol, for a later step to attach or upload.
documentslist
The file saved in Lodol.
file_idtext
The file's Filestack ID, for the other Filestack steps.
filenametext
The file's name.
output_formattext
The format it was converted to, e.g. pdf.
size_bytesnumber
Size of the file in bytes.
statustext
Status of the action execution ("success" on success).
urltext
The file's public Filestack link, ready to share or embed. It does not expire.
Example output
{
  "content_type": "application/pdf",
  "document_ref": "doc_8a7b6c5d",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_8a7b6c5d",
      "filename": "proposal.pdf",
      "size_bytes": 148992,
      "url": "/actions/core/serve-document/doc_8a7b6c5d"
    }
  ],
  "file_id": "Hk3pQz9WTe6bLmN2vXcA",
  "filename": "proposal.pdf",
  "output_format": "pdf",
  "size_bytes": 148992,
  "status": "success",
  "url": "https://cdn.filestackcontent.com/Hk3pQz9WTe6bLmN2vXcA"
}

Delete a file

Permanently delete a Filestack file. Its link stops working.

Inputs

FilefiletextRequired
The Filestack file: its file ID, which 'Upload a file' returns, or its Filestack link.

Outputs

deletedtrue/false
True once it is gone.
file_idtext
The file deleted.
statustext
Status of the action execution ("success" on success).
Example output
{
  "deleted": true,
  "file_id": "s7tdGfE5RRKFUxwsZoYv",
  "status": "success"
}

Download a file

Save a Filestack file in Lodol, so a later step can attach it to an email or upload it somewhere else.

Inputs

FilefiletextRequired
The Filestack file: its file ID, which 'Upload a file' returns, or its Filestack link.

Outputs

content_typetext
The file's media type, e.g. image/png.
document_reftext
The file, saved in Lodol, for a later step to attach or upload.
documentslist
The file saved in Lodol.
file_idtext
The file's Filestack ID, for the other Filestack steps.
filenametext
The file's name.
size_bytesnumber
Size of the file in bytes.
statustext
Status of the action execution ("success" on success).
urltext
The file's public Filestack link, ready to share or embed. It does not expire.
Example output
{
  "content_type": "application/pdf",
  "document_ref": "doc_4c1d2e3f",
  "documents": [
    {
      "content_type": "application/pdf",
      "document_ref": "doc_4c1d2e3f",
      "filename": "invoice-1042.pdf",
      "size_bytes": 84211,
      "url": "/actions/core/serve-document/doc_4c1d2e3f"
    }
  ],
  "file_id": "s7tdGfE5RRKFUxwsZoYv",
  "filename": "invoice-1042.pdf",
  "size_bytes": 84211,
  "status": "success",
  "url": "https://cdn.filestackcontent.com/s7tdGfE5RRKFUxwsZoYv"
}

Get a file

Look up a Filestack file: its name, type, size, link and when it was uploaded.

Inputs

FilefiletextRequired
The Filestack file: its file ID, which 'Upload a file' returns, or its Filestack link.

Outputs

content_typetext
The file's media type, e.g. image/png.
file_idtext
The file's Filestack ID, for the other Filestack steps.
filenametext
The file's name.
size_bytesnumber
Size of the file in bytes.
statustext
Status of the action execution ("success" on success).
uploaded_attext
When the file was uploaded, in UTC.
urltext
The file's public Filestack link, ready to share or embed. It does not expire.
Example output
{
  "content_type": "application/pdf",
  "file_id": "s7tdGfE5RRKFUxwsZoYv",
  "filename": "invoice-1042.pdf",
  "size_bytes": 84211,
  "status": "success",
  "uploaded_at": "2026-10-03T14:22:05Z",
  "url": "https://cdn.filestackcontent.com/s7tdGfE5RRKFUxwsZoYv"
}

Replace a file

Swap a Filestack file's contents for a new file. Its link and file ID stay the same, so anywhere it is shared shows the new version.

Inputs

FilefiletextRequired
The Filestack file: its file ID, which 'Upload a file' returns, or its Filestack link.
Replace withnew_filetextRequired
The new contents: upload a file, pick one from an earlier step, or paste a public link to one.

Outputs

content_typetext
The file's media type, e.g. image/png.
file_idtext
The file's Filestack ID, for the other Filestack steps.
filenametext
The file's name.
size_bytesnumber
Size of the file in bytes.
statustext
Status of the action execution ("success" on success).
urltext
The file's public Filestack link, ready to share or embed. It does not expire.
Example output
{
  "content_type": "application/pdf",
  "file_id": "s7tdGfE5RRKFUxwsZoYv",
  "filename": "invoice-1042.pdf",
  "size_bytes": 90533,
  "status": "success",
  "url": "https://cdn.filestackcontent.com/s7tdGfE5RRKFUxwsZoYv"
}

Resize an image

Make an image a different size, such as a thumbnail or a banner. Returns the resized image and a public link.

Inputs

FilefiletextRequired
The image to resize: upload one, pick one from an earlier step, paste a public link, or give a Filestack file ID.
Widthwidthnumber
The new width in pixels. Leave blank to follow the height.From 1 to 10000.
Heightheightnumber
The new height in pixels. Leave blank to follow the width.From 1 to 10000.
Fitfittext
How the image fits a width and height together. Filling and stretching need both.One of: clip (Fit inside the size, keeping its shape), crop (Fill the size, cropping the edges), scale (Stretch to exactly this size), max (Only shrink, never enlarge). Default: clip.
Save assave_astext
Optional. The resized image's name. Leave blank to add the new size to the original name.

Outputs

content_typetext
The file's media type, e.g. image/png.
document_reftext
The file, saved in Lodol, for a later step to attach or upload.
documentslist
The file saved in Lodol.
file_idtext
The file's Filestack ID, for the other Filestack steps.
filenametext
The file's name.
heightnumber
The height asked for.
size_bytesnumber
Size of the file in bytes.
statustext
Status of the action execution ("success" on success).
urltext
The file's public Filestack link, ready to share or embed. It does not expire.
widthnumber
The width asked for.
Example output
{
  "content_type": "image/jpeg",
  "document_ref": "doc_1b2c3d4e",
  "documents": [
    {
      "content_type": "image/jpeg",
      "document_ref": "doc_1b2c3d4e",
      "filename": "team-photo-400x400.jpg",
      "size_bytes": 38204,
      "url": "/actions/core/serve-document/doc_1b2c3d4e"
    }
  ],
  "file_id": "Rz8yTq2LWa5cNv7bKpXe",
  "filename": "team-photo-400x400.jpg",
  "height": 400,
  "size_bytes": 38204,
  "status": "success",
  "url": "https://cdn.filestackcontent.com/Rz8yTq2LWa5cNv7bKpXe",
  "width": 400
}

Take a screenshot of a web page

Capture a public web page as an image, as it looks on a computer or a phone. Returns the image and a public link.

Inputs

Web pagepage_urltextRequired
The page's link. It has to open without signing in.
Devicedevicetext
Show the page as it looks on a computer or a phone.One of: desktop, mobile (Phone). Default: desktop.
Capturecapturetext
The whole page, or just the part that is visible.One of: all (The whole page, top to bottom), window (Only what fits on the screen). Default: all.
Wait before capturingwait_secondsnumber
Seconds to let the page finish loading, up to 20. Leave blank for 1; raise it for pages that load slowly.From 0 to 20.
Save assave_astext
Optional. The image's name. Leave blank to name it after the site.

Outputs

content_typetext
The file's media type, e.g. image/png.
document_reftext
The file, saved in Lodol, for a later step to attach or upload.
documentslist
The file saved in Lodol.
file_idtext
The file's Filestack ID, for the other Filestack steps.
filenametext
The file's name.
size_bytesnumber
Size of the file in bytes.
statustext
Status of the action execution ("success" on success).
urltext
The file's public Filestack link, ready to share or embed. It does not expire.
Example output
{
  "content_type": "image/png",
  "document_ref": "doc_9c8d7e6f",
  "documents": [
    {
      "content_type": "image/png",
      "document_ref": "doc_9c8d7e6f",
      "filename": "example-com-screenshot.png",
      "size_bytes": 96480,
      "url": "/actions/core/serve-document/doc_9c8d7e6f"
    }
  ],
  "file_id": "Pw2sKd8FXn4hRt6yUmZo",
  "filename": "example-com-screenshot.png",
  "size_bytes": 96480,
  "status": "success",
  "url": "https://cdn.filestackcontent.com/Pw2sKd8FXn4hRt6yUmZo"
}

Upload a file

Put a file on Filestack and get a public link to share or embed, plus its file ID for the other Filestack steps.

Inputs

FilefiletextRequired
The file to upload: upload one, pick one from an earlier step, or paste a public link and Filestack will fetch it.
Save assave_astext
Optional. The name to give the file on Filestack. Leave blank to keep its own name.

Outputs

content_typetext
The file's media type, e.g. image/png.
file_idtext
The file's Filestack ID, for the other Filestack steps.
filenametext
The file's name.
size_bytesnumber
Size of the file in bytes.
statustext
Status of the action execution ("success" on success).
urltext
The file's public Filestack link, ready to share or embed. It does not expire.
Example output
{
  "content_type": "application/pdf",
  "file_id": "s7tdGfE5RRKFUxwsZoYv",
  "filename": "invoice-1042.pdf",
  "size_bytes": 84211,
  "status": "success",
  "url": "https://cdn.filestackcontent.com/s7tdGfE5RRKFUxwsZoYv"
}

On this page