---
title: "Flatfile integration for LuumenAI"
url: "https://www.luumen.ai/integrations/flatfile/"
entity: SoftwareIntegration
category: "Source control & CI/CD"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Flatfile integration for LuumenAI

Read Flatfile spaces, sheets, and records, and correct data as approved steps

## What LuumenAI can do with Flatfile

LuumenAI connects to Flatfile with an API token and exposes 12 tools (9 read-only · 2 write · 1 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 12 tools (9 read-only · 2 write · 1 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Source control & CI/CD

## About Flatfile with LuumenAI

Connect Flatfile and Luumen can trace an import end to end: which space it landed in, which workbook and sheet holds it, how the job finished, and which records failed validation. Reads answer right away. Inserts, updates, and deletes are previewed and held for your approval before anything changes in the sheet.

## Example tools

Read-only (9 in total):

- `FLATFILE_GET_JOB` — Get detailed status, outcome, result, and diagnostic information for one Flatfile asynchronous job.
- `FLATFILE_GET_SHEET` — Get one sheet's field configuration and record counts before reading or writing records.
- `FLATFILE_GET_SPACE` — Get safe metadata for one Flatfile space without exposing transient access credentials or token-bearing guest links.
- `FLATFILE_LIST_ENVIRONMENTS` — List Flatfile environments visible to the connected environment secret key and return the IDs needed to find spaces.
- `FLATFILE_LIST_FILES` — Discover import or export files and their processing status, optionally within a Flatfile space.
- `FLATFILE_LIST_JOBS` — Find asynchronous Flatfile jobs by environment, space, workbook, file, or parent job and inspect progress at a glance.
- `FLATFILE_LIST_RECORDS` — Read one page of records from a Flatfile sheet, optionally filtering by validity, field, record ID, search value, or FFQL expression.
- `FLATFILE_LIST_SPACES` — Find Flatfile spaces by environment, text, namespace, archive state, or template status.

Write and destructive (3 in total, subject to configured approval policy):

- `FLATFILE_DELETE_RECORDS` — Permanently delete one to 100 explicitly identified records from one Flatfile sheet.
- `FLATFILE_INSERT_RECORDS` — Insert one or more rows into a Flatfile sheet using simple field-key to value objects.
- `FLATFILE_UPDATE_RECORDS` — Update one or more existing Flatfile records by ID using simple field-key to value objects.

## Frequently asked questions

### How does LuumenAI connect to Flatfile?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Flatfile on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

Every call to Flatfile — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/flatfile/