# SourceFolder-Input

Type: object

Fields typed as another model are documented on that model's page; fetch it before filling the field.

| Field | Type | Required | Description | Allowed values / default / constraints |
| --- | --- | --- | --- | --- |
| `type` | string | yes | Marks this source as a **folder**: every matching file inside it is read. | const: `"folder"` |
| `provider` | [Provider](https://dev-api.sheetgo.com/rest/reference/models/Provider.md) | yes | The storage provider that hosts the file or folder |  |
| `id` | string | yes | Id of the source file or folder |  |
| `file_type` | string | yes | Always `folder`. Fixed by the source type; present so folder and file sources share one shape. | const: `"folder"` |
| `sheet_tabs` | string or [SourceAllTabs](https://dev-api.sheetgo.com/rest/reference/models/SourceAllTabs.md) or array of string, nullable | no | One or more sheet tab names or all_tabs |  |
| `data_ranges` | string, nullable | no | The data range |  |
| `offset_header` | integer, nullable | no | The header position | default: `1` |
| `date_format` | string, nullable | no | Format for date fields | default: `"#month/day/YEAR"` |
| `content_type` | [ContentType](https://dev-api.sheetgo.com/rest/reference/models/ContentType.md) | no | `spreadsheets` reads Sheets / Excel / CSV / TSV files. `documents` reads Google Docs, PDF, Word (.docx) and text files through the AI step (`ai.prompt` required). | default: `"spreadsheets"` |
| `include_subfolders` | boolean | no | Also read files inside subfolders. | default: `false` |
| `import` | [ImportMode](https://dev-api.sheetgo.com/rest/reference/models/ImportMode.md) | no | Which files to import, by modified time: every file newest or oldest first, or only the newest / oldest one. Applied after `file_filter` and `process_once`. | default: `"all_newest_first"` |
| `process_once` | boolean | no | Documents only: skip files already read by an earlier run (new or changed files are read again). Ignored for spreadsheets. | default: `true` |
| `file_filter` | [FileFilter-Input](https://dev-api.sheetgo.com/rest/reference/models/FileFilter-Input.md), nullable | no | Only read the files that match these conditions. |  |

## Used by

- [POST /rest/beta/automations/](https://dev-api.sheetgo.com/rest/reference/automations.md#post-rest-beta-automations)
- [PUT /rest/beta/automations/{id}](https://dev-api.sheetgo.com/rest/reference/automations.md#put-rest-beta-automations-id)
- [AutomationCreate](https://dev-api.sheetgo.com/rest/reference/models/AutomationCreate.md)
- [AutomationReplace](https://dev-api.sheetgo.com/rest/reference/models/AutomationReplace.md)

---

More: start page https://dev-api.sheetgo.com/rest/reference.md, everything in one file https://dev-api.sheetgo.com/rest/llms-full.txt, OpenAPI https://dev-api.sheetgo.com/rest/openapi.json.