This article describes the configuration options for managing Celigo Storage files and folders using record-based steps in the Celigo APIs connector. Use these steps to automate file management operations — such as listing, searching, moving, or deleting files and folders — as part of your integration logic.
Note
The record-based operations in this article work on file and folder metadata. To read or write file contents, use the file transfer step types instead.
Before you begin: Set up a connection to Celigo APIs. The connection scope must be Full access, Custom, or Integration access.
-
Name your export or lookup — Name your resource so that you can easily reference it from other parts of the application.
-
Description — Describe your resource so that other users can quickly understand what it is doing without having to read through all the fields and settings. Also, keep this field up to date as you make changes to the resource.
-
Connection — Select an existing Celigo APIs connection, or select Create connection to define a new one.
-
Resource — Select File storage.
-
Operation — Select the action to perform. Available operations are described in the sections below.
Use the Celigo Storage operations to fully automate and scale your file management within integration flows. By leveraging these record-based steps to programmatically list, search, move, rename, or delete assets, you eliminate the need for manual file intervention, minimize data handling errors, and establish dynamic, self-sustaining data pipelines that adapt automatically to changing directory contents.
Retrieves a list of files and folders from a specified Celigo Storage folder.
-
Folder — The folder to list. Supports Browse, Relative path, and Folder ID input modes. See following section in this article: Directory input modes.
-
Include subfolders — When checked, results include files and folders from all subfolders beneath the specified folder, not just the immediate contents.
Searches for files and folders by name across Celigo Storage.
-
Search term — The name or partial name to search for. Minimum 3 characters. Search is recursive — results include matching items from the entire account root and all nested folders, regardless of the Folder setting.
-
Folder — Optionally scope the search to a specific folder and its subfolders. Supports Browse, Relative path, and Folder ID input modes. Leave empty to search across the entire account.
-
File type filter — Optionally filter results by file type (JSON, CSV, XML, EDI, Spreadsheets, PDFs, Plain Text, Archives, Images, Videos, Audio, Other, or Folders only).
Retrieves metadata for a specific file: name, size, last modified date, description, and internal ID.
-
File ID — The internal Celigo Storage ID of the file. Supports Handlebars expressions so you can reference a file ID from earlier in the flow — for example, from a List or Search step result.
Moves a file to the Celigo Storage recycle bin.
-
File ID — The internal Celigo Storage ID of the file to delete. Supports Handlebars expressions.
Note
Note: The deleted file moves to the recycle bin and continues counting toward storage usage until it is permanently purged.
Creates a new folder in Celigo Storage.
-
Parent folder — The folder in which to create the new folder. Supports Browse, Relative path, and Folder ID input modes. Leave empty to create the folder in the root directory.
-
Folder name — The name for the new folder. Folder names are case-sensitive and must be unique within the same parent folder.
Moves a folder and all of its contents — including all subfolders and files — to the recycle bin.
-
Folder ID — The internal Celigo Storage ID of the folder to delete. Supports Handlebars expressions.
Note
Note: This operation moves the folder and all of its contents to the recycle bin. Contents continue counting toward storage usage until purged.
Moves a file to a different folder in Celigo Storage.
-
File ID — The internal Celigo Storage ID of the file to move. Supports Handlebars expressions.
-
Destination folder — The folder to move the file into. Supports Browse, Relative path, and Folder ID input modes.
-
If a file with the same name exists — Choose Keep both to create the moved file with a number appended to the name, or Replace existing to overwrite the file at the destination.
Renames a file or folder in Celigo Storage. Renaming doesn't break any existing MCP server or flow references to the item — references use stable internal IDs, not display names.
-
Resource type — Select File or Folder.
-
File ID or Folder ID — The internal Celigo Storage ID of the item to rename. Supports Handlebars expressions.
-
New name — The new name for the file (including file extension) or folder. Names are case-sensitive and must be unique within the same parent folder.
-
If a file with the same name exists (files only) — Choose Keep both to save the renamed file with a number appended, or Replace existing to overwrite the existing file. Folder renames have no collision prompt — folder names must be unique within the same parent.
The Folder and Destination folder fields in record-based operations support three input modes:
-
Browse — Opens a visual folder picker loaded from Celigo Storage. Select a folder to write its ID back to the field automatically. Search is scoped to the current folder. Folder creation is not available — create folders in Celigo Storage (Resources > File storage) before browsing.
-
Relative path — Enter a path relative to the Celigo Storage root directory. Resolved at runtime. Supports Handlebars expressions for dynamic paths.
-
Folder ID — Enter the Celigo Storage folder ID directly. Folder IDs are stable across renames and moves. Supports Handlebars expressions.