filescom-api — quality + safety report

---
name: filescom-api
description: "Files.com API skill. Use when working with Files.com for sessions, action_logs, action_notification_exports. Covers 324 endpoints."
version: 1.0.0
generator: lapsh
---

# Files.com API
API version: 0.0.1

## Auth
ApiKey X-FilesAPI-Key in header

## Base URL
https://app.files.com/api/rest/v1

## Setup
1. Set your API key in the appropriate header
2. GET /action_logs -- verify access
3. POST /sessions -- create first sessions

## Endpoints

324 endpoints across 99 groups. See references/api-spec.lap for full details.

### sessions
| Method | Path | Description |
|--------|------|-------------|
| DELETE | /sessions | Delete user session (log out) |
| POST | /sessions | Create user session (log in) |

### action_logs
| Method | Path | Description |
|--------|------|-------------|
| GET | /action_logs | List Action Logs |

### action_notification_exports
| Method | Path | Description |
|--------|------|-------------|
| POST | /action_notification_exports | Create Action Notification Export |
| GET | /action_notification_exports/{id} | Show Action Notification Export |

### action_notification_export_results
| Method | Path | Description |
|--------|------|-------------|
| GET | /action_notification_export_results | List Action Notification Export Results |

### api_key
| Method | Path | Description |
|--------|------|-------------|
| DELETE | /api_key | Delete current API key.  (Requires current API connection to be using an API key.) |
| PATCH | /api_key | Update current API key.  (Requires current API connection to be using an API key.) |
| GET | /api_key | Show information about current API key.  (Requires current API connection to be using an API key.) |

### api_keys
| Method | Path | Description |
|--------|------|-------------|
| DELETE | /api_keys/{id} | Delete API Key |
| PATCH | /api_keys/{id} | Update API Key |
| GET | /api_keys/{id} | Show API Key |
| POST | /api_keys | Create API Key |
| GET | /api_keys | List API Keys |

### site
| Method | Path | Description |
|--------|------|-------------|
| GET | /site/usage | Get the most recent usage snapshot (usage data for billing purposes) for a Site. |
| PATCH | /site | Update Site Settings |
| GET | /site | Show Site Settings |
| GET | /site/ip_addresses | List IP Addresses associated with the current site |
| GET | /site/dns_records | Show Site DNS Configuration |
| POST | /site/test-webhook | Test Webhook |
| POST | /site/api_keys | Create API Key |
| GET | /site/api_keys | List API Keys |

### user
| Method | Path | Description |
|--------|------|-------------|
| PATCH | /user | Update User |
| POST | /user/public_keys | Create Public Key |
| GET | /user/public_keys | List Public Keys |
| GET | /user/groups | List Group Users |
| POST | /user/api_keys | Create API Key |
| GET | /user/api_keys | List API Keys |

### users
| Method | Path | Description |
|--------|------|-------------|
| POST | /users/{id}/unlock | Unlock user who has been locked out due to failed logins. |
| POST | /users/{id}/resend_welcome_email | Resend user welcome email |
| POST | /users/{id}/2fa/reset | Trigger 2FA Reset process for user who has lost access to their existing 2FA methods. |
| DELETE | /users/{id} | Delete User |
| PATCH | /users/{id} | Update User |
| GET | /users/{id} | Show User |
| POST | /users | Create User |
| GET | /users | List Users |
| GET | /users/{user_id}/sftp_client_uses | List User SFTP Client Uses |
| GET | /users/{user_id}/cipher_uses | List User Cipher Uses |
| POST | /users/{user_id}/public_keys | Create Public Key |
| GET | /users/{user_id}/public_keys | List Public Keys |
| GET | /users/{user_id}/permissions | List Permissions |
| GET | /users/{user_id}/groups | List Group Users |
| POST | /users/{user_id}/api_keys | Create API Key |
| GET | /users/{user_id}/api_keys | List API Keys |

### api_request_logs
| Method | Path | Description |
|--------|------|-------------|
| GET | /api_request_logs | List API Request Logs |

### apps
| Method | Path | Description |
|--------|------|-------------|
| GET | /apps | List Apps |

### as2_incoming_messages
| Method | Path | Description |
|--------|------|-------------|
| GET | /as2_incoming_messages | List AS2 Incoming Messages |

### as2_outgoing_messages
| Method | Path | Description |
|--------|------|-------------|
| GET | /as2_outgoing_messages | List AS2 Outgoing Messages |

### as2_partners
| Method | Path | Description |
|--------|------|-------------|
| DELETE | /as2_partners/{id} | Delete AS2 Partner |
| PATCH | /as2_partners/{id} | Update AS2 Partner |
| GET | /as2_partners/{id} | Show AS2 Partner |
| POST | /as2_partners | Create AS2 Partner |
| GET | /as2_partners | List AS2 Partners |

### as2_stations
| Method | Path | Description |
|--------|------|-------------|
| DELETE | /as2_stations/{id} | Delete AS2 Station |
| PATCH | /as2_stations/{id} | Update AS2 Station |
| GET | /as2_stations/{id} | Show AS2 Station |
| POST | /as2_stations | Create AS2 Station |
| GET | /as2_stations | List AS2 Stations |

### automations
| Method | Path | Description |
|--------|------|-------------|
| POST | /automations/{id}/manual_run | Manually Run Automation |
| DELETE | /automations/{id} | Delete Automation |
| PATCH | /automations/{id} | Update Automation |
| GET | /automations/{id} | Show Automation |
| POST | /automations | Create Automation |
| GET | /automations | List Automations |

### automation_logs
| Method | Path | Description |
|--------|------|-------------|
| GET | /automation_logs | List Automation Logs |

### automation_runs
| Method | Path | Description |
|--------|------|-------------|
| GET | /automation_runs/{id} | Show Automation Run |
| GET | /automation_runs | List Automation Runs |

### bandwidth_snapshots
| Method | Path | Description |
|--------|------|-------------|
| GET | /bandwidth_snapshots | List Bandwidth Snapshots |

### behaviors
| Method | Path | Description |
|--------|------|-------------|
| POST | /behaviors/webhook/test | Test Webhook |
| DELETE | /behaviors/{id} | Delete Behavior |
| PATCH | /behaviors/{id} | Update Behavior |
| GET | /behaviors/{id} | Show Behavior |
| POST | /behaviors | Create Behavior |
| GET | /behaviors | List Behaviors |
| GET | /behaviors/folders/{path} | List Behaviors by Path |

### bundle_actions
| Method | Path | Description |
|--------|------|-------------|
| GET | /bundle_actions | List Bundle Actions |

### bundle_downloads
| Method | Path | Description |
|--------|------|-------------|
| GET | /bundle_downloads | List Share Link Downloads |

### bundle_notifications
| Method | Path | Description |
|--------|------|-------------|
| DELETE | /bundle_notifications/{id} | Delete Share Link Notification |
| PATCH | /bundle_notifications/{id} | Update Share Link Notification |
| GET | /bundle_notifications/{id} | Show Share Link Notification |
| POST | /bundle_notifications | Create Share Link Notification |
| GET | /bundle_notifications | List Share Link Notifications |

### bundle_recipients
| Method | Path | Description |
|--------|------|-------------|
| POST | /bundle_recipients | Create Share Link Recipient |
| GET | /bundle_recipients | List Share Link Recipients |

### bundle_registrations
| Method | Path | Description |
|--------|------|-------------|
| GET | /bundle_registrations | List Share Link Registrations |

### bundles
| Method | Path | Description |
|--------|------|-------------|
| GET | /bundles/{id} | Show Share Link |
| PATCH | /bundles/{id} | Update Share Link |
| DELETE | /bundles/{id} | Delete Share Link |
| GET | /bundles | List Share Links |
| POST | /bundles | Create Share Link |
| POST | /bundles/{id}/share | Send email(s) with a link to bundle |

### child_site_management_policies
| Method | Path | Description |
|--------|------|-------------|
| DELETE | /child_site_management_policies/{id} | Delete Child Site Management Policy |
| PATCH | /child_site_management_policies/{id} | Update Child Site Management Policy |
| GET | /child_site_management_policies/{id} | Show Child Site Management Policy |
| POST | /child_site_management_policies | Create Child Site Management Policy |
| GET | /child_site_management_policies | List Child Site Management Policies |

### clickwraps
| Method | Path | Description |
|--------|------|-------------|
| GET | /clickwraps | List Clickwraps |
| POST | /clickwraps | Create Clickwrap |
| DELETE | /clickwraps/{id} | Delete Clickwrap |
| PATCH | /clickwraps/{id} | Update Clickwrap |
| GET | /clickwraps/{id} | Show Clickwrap |

### dns_records
| Method | Path | Description |
|--------|------|-------------|
| GET | /dns_records | Show Site DNS Configuration |

### email_incoming_messages
| Method | Path | Description |
|--------|------|-------------|
| GET | /email_incoming_messages | List Email Incoming Messages |

### email_logs
| Method | Path | Description |
|--------|------|-------------|
| GET | /email_logs | List Email Logs |

### exavault_api_request_logs
| Method | Path | Description |
|--------|------|-------------|
| GET | /exavault_api_request_logs | List Exavault API Request Logs |

### external_events
| Method | Path | Description |
|--------|------|-------------|
| POST | /external_events | Create External Event |
| GET | /external_events | List External Events |
| GET | /external_events/{id} | Show External Event |

### files
| Method | Path | Description |
|--------|------|-------------|
| DELETE | /files/{path} | Delete File/Folder |
| PATCH | /files/{path} | Update File/Folder Metadata |
| POST | /files/{path} | Upload File |
| GET | /files/{path} | Download File |

### file_actions
| Method | Path | Description |
|--------|------|-------------|
| GET | /file_actions/metadata/{path} | Find File/Folder by Path |
| POST | /file_actions/copy/{path} | Copy File/Folder |
| POST | /file_actions/move/{path} | Move File/Folder |
| POST | /file_actions/unzip | Extract a ZIP file to a destination folder. |
| GET | /file_actions/zip_list/{path} | List the contents of a ZIP file. |
| POST | /file_actions/zip | Create a ZIP from one or more paths and save it to a destination path. |
| POST | /file_actions/begin_upload/{path} | Begin File Upload |

### file_comments
| Method | Path | Description |
|--------|------|-------------|
| DELETE | /file_comments/{id} | Delete File Comment |
| PATCH | /file_comments/{id} | Update File Comment |
| POST | /file_comments | Create File Comment |
| GET | /file_comments/files/{path} | List File Comments by Path |

### file_comment_reactions
| Method | Path | Description |
|--------|------|-------------|
| DELETE | /file_comment_reactions/{id} | Delete File Comment Reaction |
| POST | /file_comment_reactions | Create File Comment Reaction |

### file_migrations
| Method | Path | Description |
|--------|------|-------------|
| GET | /file_migrations/{id} | Show File Migration |

### file_migration_logs
| Method | Path | Description |
|--------|------|-------------|
| GET | /file_migration_logs | List File Migration Logs |

### folders
| Method | Path | Description |
|--------|------|-------------|
| POST | /folders/{path} | Create Folder |
| GET | /folders/{path} | List Folders by Path |

### form_field_sets
| Method | Path | Description |
|--------|------|-------------|
| DELETE | /form_field_sets/{id} | Delete Form Field Set |
| PATCH | /form_field_sets/{id} | Update Form Field Set |
| GET | /form_field_sets/{id} | Show Form Field Set |
| POST | /form_field_sets | Create Form Field Set |
| GET | /form_field_sets | List Form Field Sets |

### ftp_action_logs
| Method | Path | Description |
|--------|------|-------------|
| GET | /ftp_action_logs | List FTP Action Logs |

### groups
| Method | Path | Description |
|--------|------|-------------|
| POST | /groups/{group_id}/users | Create User |
| GET | /groups/{group_id}/users | List Group Users |
| GET | /groups/{group_id}/permissions | List Permissions |
| DELETE | /groups/{group_id}/memberships/{user_id} | Delete Gro

… (truncated)