# Files.com - Search records action

The Search records action searches for a record in Files.com.

# Input

Input field Description
Object Select the type of object to search for records of, such as File/Folder.
Path Enter the path to the folder to search for records.
Search Enter a name to search folders or files by. Results are best-effort and not real-time. Results are truncated at 1,000 matches.
Search custom metadata key Enter a custom metadata key to search for. Enter * to return results for any metadata key.
Search all Select Yes to search the entire site. Select No to only search a section on the site.
Type Select the type of object to return. For example, File and Folder.
Modified at datetime Select a date to only return records modified after this time. You can only use this input field with the Type input field.
Preview size Select the preview size for the returned record. Options include, Small, Large, Extra large, and PDF. The default is Small.
With previews Select whether to include file preview information in the response.
With priority color Select whether to include file priority color information in the response.
Sort by Enter a fields and direction to sort the returned records by. Options include, path, size, modified_at_datetime, and provided_modified_at.
Per page Enter the number of records to return on each page.
Page Enter the index of the page to return from the results list.

# Output

The following are the most common output fields. Refer to the Files.com (opens new window) documentation for a complete list of output fields.

Output field Description
Path The path where the returned record is located. For example: folder/file.txt.
Created by ID The ID of the user that created the record.
Display name The name of the returned record that is displayed.
Type The type of returned record.
Size The size of the returned record.
Created at The time that the record was created.


Last updated: 2/24/2026, 6:47:33 PM

On this page