# Flatfile API Documentation

This is the complete API documentation for connecting to the Flatfile 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 **Flatfile connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

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

## Flatfile actions

- PUT `acknowledge-job` Acknowledge Job
- PUT `archive-space` Archive Space
- PUT `bulk-update-records` Bulk Update Records
- POST `clone-file` Clone File
- PUT `complete-job` Complete Job
- POST `create-job` Create Job
- POST `create-space` Create Space
- POST `create-workbook` Create Workbook
- DELETE `delete-file` Delete File
- DELETE `delete-job` Delete Job
- DELETE `delete-records` Delete Records
- DELETE `delete-sheet` Delete Sheet
- DELETE `delete-space` Delete Space
- DELETE `delete-workbook` Delete Workbook
- POST `detect-file-header` Detect File Header
- GET `download-file` Download File
- POST `duplicate-sheet` Duplicate Sheet
- PUT `execute-job` Execute Job
- PUT `find-and-replace-records` Find And Replace Records
- GET `get-cell-values` Get Cell Values
- GET `get-current-account` Get Current Account
- GET `get-environment` Get Environment
- GET `get-file` Get File
- GET `get-job` Get Job
- GET `get-job-execution-plan` Get Job Execution Plan
- GET `get-publishable-key` Get Publishable Key
- GET `get-record-counts` Get Record Counts
- GET `get-record-indices` Get Record Indices
- GET `get-records` Get Records
- GET `get-sheet` Get Sheet
- GET `get-sheet-commits` Get Sheet Commits
- GET `get-space` Get Space
- GET `get-workbook` Get Workbook
- GET `get-workbook-commits` Get Workbook Commits
- POST `insert-records` Insert Records
- GET `list-calculations` List Calculations
- GET `list-environments` List Environments
- GET `list-files` List Files
- GET `list-jobs` List Jobs
- GET `list-sheets` List Sheets
- GET `list-spaces` List Spaces
- GET `list-workbooks` List Workbooks
- PUT `unarchive-space` Unarchive Space
- PUT `update-file` Update File
- PUT `update-job` Update Job
- PUT `update-records` Update Records
- PUT `update-sheet` Update Sheet
- PUT `update-space` Update Space
- PUT `update-workbook` Update Workbook
- POST `upload-file` Upload File
- PUT `validate-sheet` Validate Sheet