# Files.com API Documentation

This is the complete API documentation for connecting to the Files.com API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Files.com connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/filescom/actions/{actionSlug}/run
```

## Files.com actions

- POST `begin-file-upload` Begin File Upload
- POST `copy-file-or-folder` Copy File or Folder
- POST `create-folder` Create Folder
- DELETE `delete-file-or-folder` Delete File or Folder
- GET `get-automation` Get Automation
- GET `get-bundle` Get Bundle
- GET `get-file-download-link` Get File Download Link
- GET `get-file-or-folder-metadata` Get File or Folder Metadata
- GET `get-group` Get Group
- GET `get-notification` Get Notification
- GET `get-project` Get Project
- GET `get-site` Get Site
- GET `get-site-usage` Get Site Usage
- GET `get-sync` Get Sync
- GET `get-user` Get User
- GET `get-workspace` Get Workspace
- GET `list-automations` List Automations
- GET `list-bundles` List Bundles
- GET `list-file-comments` List File Comments
- GET `list-file-history` List File History
- GET `list-folder-contents` List Folder Contents
- GET `list-folder-history` List Folder History
- GET `list-groups` List Groups
- GET `list-history` List History
- GET `list-login-history` List Login History
- GET `list-notifications` List Notifications
- GET `list-permissions` List Permissions
- GET `list-projects` List Projects
- GET `list-requests` List Requests
- GET `list-requests-by-folder-path` List Requests by Folder Path
- GET `list-syncs` List Syncs
- GET `list-user-history` List User History
- GET `list-users` List Users
- GET `list-workspaces` List Workspaces
- PUT `move-file-or-folder` Move File or Folder
- PUT `run-automation-now` Run Automation Now
- PUT `run-sync-now` Run Sync Now
- PUT `update-file-or-folder-metadata` Update File or Folder Metadata