{
  "info": {
    "name": "Flatfile — mcp.ai",
    "description": "REST API for the Flatfile MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/flatfile",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "flatfile_delete_records",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/records",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "records"
          ]
        },
        "description": "Permanently 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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sheet_id\": \"\",\n  \"record_ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "flatfile_get_job",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/job",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "job"
          ]
        },
        "description": "Get detailed status, outcome, result, and diagnostic information for one Flatfile asynchronous job.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"job_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "flatfile_get_sheet",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/sheet",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "sheet"
          ]
        },
        "description": "Get one sheet's field configuration and record counts before reading or writing records.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sheet_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "flatfile_get_space",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/space",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "space"
          ]
        },
        "description": "Get safe metadata for one Flatfile space without exposing transient access credentials or token-bearing guest links.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"space_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "flatfile_insert_records",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/insert/records",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "insert",
            "records"
          ]
        },
        "description": "Insert 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 ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"records\": \"\",\n  \"sheet_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "flatfile_list_environments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/environments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "environments"
          ]
        },
        "description": "List Flatfile environments visible to the connected environment secret key and return the IDs needed to find spaces.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"cursor\": \"\",\n  \"page_size\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "flatfile_list_files",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/files",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "files"
          ]
        },
        "description": "Discover import or export files and their processing status, optionally within a Flatfile space.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"mode\": \"\",\n  \"cursor\": \"\",\n  \"space_id\": \"\",\n  \"page_size\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "flatfile_list_jobs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/jobs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "jobs"
          ]
        },
        "description": "Find asynchronous Flatfile jobs by environment, space, workbook, file, or parent job and inspect progress at a glance.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"cursor\": \"\",\n  \"source\": \"\",\n  \"file_id\": \"\",\n  \"space_id\": \"\",\n  \"page_size\": 0,\n  \"workbook_id\": \"\",\n  \"parent_job_id\": \"\",\n  \"environment_id\": \"\",\n  \"sort_direction\": \"\",\n  \"exclude_child_jobs\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "flatfile_list_records",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/records",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "records"
          ]
        },
        "description": "Read one page of records from a Flatfile sheet, optionally filtering by validity, field, record ID, search value, or FFQL expression.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"query\": \"\",\n  \"cursor\": \"\",\n  \"fields\": \"\",\n  \"filter\": \"\",\n  \"sheet_id\": \"\",\n  \"page_size\": 0,\n  \"record_ids\": \"\",\n  \"filter_field\": \"\",\n  \"search_field\": \"\",\n  \"search_value\": \"\",\n  \"include_links\": false,\n  \"include_messages\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "flatfile_list_spaces",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/spaces",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "spaces"
          ]
        },
        "description": "Find Flatfile spaces by environment, text, namespace, archive state, or template status.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"cursor\": \"\",\n  \"search\": \"\",\n  \"archived\": false,\n  \"namespace\": \"\",\n  \"page_size\": 0,\n  \"environment_id\": \"\",\n  \"is_app_template\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "flatfile_list_workbooks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/workbooks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "workbooks"
          ]
        },
        "description": "List workbooks, optionally within a space, with their nested sheets so an agent can continue to sheet and record tasks.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"label\": \"\",\n  \"space_id\": \"\",\n  \"namespace\": \"\",\n  \"include_sheets\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "flatfile_update_records",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/records",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "records"
          ]
        },
        "description": "Update 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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"records\": \"\",\n  \"sheet_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}