NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Files.com connects to a Nagent workspace with an API key. Once it is connected, agents can call 7 Files.com actions, such as "Get S3 Key for Upload", "List Folders" and "List Groups". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Files.com, with input parameters and output schema.
FILES_COM_DELETE_API_KEYTool to delete an API key. Use when you need to revoke an API key after confirming its identifier.
Input parameters
The unique identifier of the API key to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILES_COM_DELETE_PERMISSIONRemoves a permission grant that allows a user or group to access a specific file or folder path on Files.com. A permission ID can be obtained from the LIST_PERMISSIONS action. Use this tool when you need to revoke access that was previously granted to a user or group for a specific resource. Note: Requires administrative permissions on the Files.com site.
Input parameters
The unique identifier of the permission to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILES_COM_DELETE_SHAREDelete a specified share link (bundle) on Files.com. This operation is idempotent - it succeeds even if the share link has already been deleted or doesn't exist. Use this to revoke public access to shared files/folders when you have the share ID.
Input parameters
ID of the share link (bundle) to delete. This operation is idempotent - returns success even if the share doesn't exist (404).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILES_COM_GET_S3_KEY_FOR_UPLOADTool to generate a temporary key for file uploads by uploading the file to Files.com. Useful when you need to host a local file temporarily before importing or sharing.
Input parameters
File object to upload for temporary hosting on Files.com
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILES_COM_LIST_FOLDERSLists folders in Files.com with optional filtering, sorting, and pagination. Returns a paginated list of folders with metadata. Useful for browsing folder structure, finding specific folders by name, or retrieving folders under a specific parent.
Input parameters
Page number for pagination (1-indexed).
Partial name filter for folders.
Number of folders per page.
ID of the parent folder to list folders for. Defaults to root.
Sort folders by path in ascending or descending order.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILES_COM_LIST_GROUPSRetrieves a paginated list of all groups from Files.com. Groups are used to organize users and manage permissions collectively. Use this action to discover available groups, check group membership, or before performing group-based permission operations. Returns group details including IDs, names, member lists, and access permissions (FTP, SFTP, WebDAV, REST API).
Input parameters
Page number to retrieve (1-indexed).
Number of groups to return per page (max 1000).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
FILES_COM_LIST_PERMISSIONSRetrieve permissions for a specified path on Files.com. Use when you need to inspect who has access and what level for a given file or folder path.
Input parameters
Page number for pagination (1-based).
Permission path. Scopes all permissions (including upward) to this path.
Filter by specific user ID.
Filter by specific group ID.
Number of items per page for pagination.
Filter by specific partner ID.
Include user permissions inherited from groups.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 7 Files.com actions on Nagent, including "Get S3 Key for Upload", "List Folders" and "List Groups". Get S3 Key for Upload: Generate a temporary key for file uploads by uploading the file to Files.com. Each action is listed on this page with its input parameters and its output.
Files.com connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Get S3 Key for Upload takes 1 required input: file. It returns data, error and successful.