Flatfile for AI agents
Agents read Flatfile at once. Changes and sends are held for a person's approval by default.
About Flatfile
Flatfile is a data exchange platform for collecting, validating, transforming, and managing structured data across collaborative workflows.
What an agent can do in Flatfile
Every Flatfile action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Flatfile without asking first. 9 actions.
- Get JobGet detailed status, outcome, result, and diagnostic information for one Flatfile asynchronous job.
- Get SheetGet one sheet's field configuration and record counts before reading or writing records.
- Get SpaceGet safe metadata for one Flatfile space without exposing transient access credentials or token-bearing guest links.
- List EnvironmentsList Flatfile environments visible to the connected environment secret key and return the IDs needed to find spaces.
- List FilesDiscover import or export files and their processing status, optionally within a Flatfile space.
- List JobsFind asynchronous Flatfile jobs by environment, space, workbook, file, or parent job and inspect progress at a glance.
- List RecordsRead one page of records from a Flatfile sheet, optionally filtering by validity, field, record ID, search value, or FFQL expression.
- List SpacesFind Flatfile spaces by environment, text, namespace, archive state, or template status.
- List WorkbooksList workbooks, optionally within a space, with their nested sheets so an agent can continue to sheet and record tasks.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 3 actions.
- Delete RecordsPermanently delete one to 100 explicitly identified records from one Flatfile sheet. This action never performs an unfiltered delete. Flatfile hooks are disabled, so these deletions do not trigger hoo
- Insert RecordsInsert one or more rows into a Flatfile sheet using simple field-key to value objects. Returns Flatfile's success receipt and commit ID, not created record IDs. Use List Records separately when later
- Update RecordsUpdate one or more existing Flatfile records by ID using simple field-key to value objects. Flatfile hooks are disabled, so these updates do not trigger hook-driven workflows.
Changes wait in Needs you
Changes and sends in Flatfile are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
Flatfile questions
Can an agent change data in Flatfile on its own?
Not by default. Changes and sends in Flatfile are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Flatfile?
This connector lists 9 read actions. Reads run at once, without waiting for approval.
How does Flatfile connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.