> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/merge-unified/filestorage/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # File Storage > Build once. Connect to every API, tool, and LLM. Ship products and agents to production without owning the integration stack. ## Docs - [File Storage](https://docs.merge.dev/merge-unified/filestorage/overview.md): File Storage API overview. Covers base URL, authentication, SDKs, rate limits, sync frequency, and available Common Models for files, folders, and drives. - [Overview](https://docs.merge.dev/merge-unified/filestorage/integrations/overview.md) - [Supported fields](https://docs.merge.dev/merge-unified/filestorage/integrations/supported-fields.md) - [Supported features](https://docs.merge.dev/merge-unified/filestorage/integrations/supported-features.md) - [Sandboxes](https://docs.merge.dev/merge-unified/filestorage/integrations/sandboxes.md): Merge-hosted sandbox environments with pre-populated sample data for testing. Available on Professional and Enterprise plans. Covers setup and requesting access. - [Box](https://docs.merge.dev/merge-unified/filestorage/integrations/box.md) - [Dropbox](https://docs.merge.dev/merge-unified/filestorage/integrations/dropbox.md) - [Google Drive](https://docs.merge.dev/merge-unified/filestorage/integrations/google-drive.md) - [OneDrive](https://docs.merge.dev/merge-unified/filestorage/integrations/onedrive.md) - [SharePoint](https://docs.merge.dev/merge-unified/filestorage/integrations/sharepoint.md) - [Authentication](https://docs.merge.dev/merge-unified/filestorage/merge-api-basics/authentication.md): How to authenticate: API key in the Authorization header (Bearer token) and Linked Account token in the X-Account-Token header. Includes SDK examples. - [Pagination](https://docs.merge.dev/merge-unified/filestorage/merge-api-basics/pagination.md): Cursor-based pagination for list endpoints. Covers the next/previous cursor fields in responses and how to page through large result sets. - [Merge SDKs](https://docs.merge.dev/merge-unified/filestorage/merge-api-basics/sdks.md): Official SDK installation and usage for all supported languages. Includes links to GitHub repos and package managers. - [Rate limits](https://docs.merge.dev/merge-unified/filestorage/merge-api-basics/rate-limits.md): Rate limit tiers by plan (Launch, Professional, Enterprise) and per-Linked-Account request limits. - [Sync frequency](https://docs.merge.dev/merge-unified/filestorage/merge-api-basics/sync-frequency.md): How often Merge syncs data from third-party integrations. Covers default intervals by plan tier (Launch, Professional, Enterprise) and per-category sync schedules. - [Versioning](https://docs.merge.dev/merge-unified/filestorage/merge-api-basics/versioning.md): Merge's API versioning strategy and commitment to backward compatibility. - [File Picker](https://docs.merge.dev/merge-unified/filestorage/file-picker.md): Merge's embedded File Picker UI for browsing files, folders, and drives in a connected File Storage account. Built into Merge Link. - [The Drive object](https://docs.merge.dev/merge-unified/filestorage/common-models/drives/the-drive-object.md) - [The File object](https://docs.merge.dev/merge-unified/filestorage/common-models/files/the-file-object.md) - [The Folder object](https://docs.merge.dev/merge-unified/filestorage/common-models/folders/the-folder-object.md) - [The Group object](https://docs.merge.dev/merge-unified/filestorage/common-models/groups/the-group-object.md) - [The User object](https://docs.merge.dev/merge-unified/filestorage/common-models/users/the-user-object.md) - [Issues](https://docs.merge.dev/merge-unified/filestorage/linked-account/issues.md): What a Merge Issue is, how the ONGOING and RESOLVED statuses change, and how to read issues through the API or react to them through webhooks. - [Field Mapping](https://docs.merge.dev/merge-unified/filestorage/linked-account/field-mapping.md): How to map custom fields from third-party integrations onto Merge Common Model fields. Covers creating target fields, configuring mappings per integration, and accessing mapped data via the API. - [Scopes](https://docs.merge.dev/merge-unified/filestorage/data-management/scopes.md): How to use Common Model Scopes to restrict which models and fields Merge syncs. Configure scopes globally or per Linked Account to limit data access. ## API Docs - File Storage > Common Models > Drives [/drives](https://docs.merge.dev/merge-unified/filestorage/common-models/drives/list.md) - File Storage > Common Models > Drives [/drives/{id}](https://docs.merge.dev/merge-unified/filestorage/common-models/drives/retrieve.md) - File Storage > Common Models > Files [/files](https://docs.merge.dev/merge-unified/filestorage/common-models/files/list.md) - File Storage > Common Models > Files [/files/{id}](https://docs.merge.dev/merge-unified/filestorage/common-models/files/retrieve.md) - File Storage > Common Models > Files [/files/{id}/download](https://docs.merge.dev/merge-unified/filestorage/common-models/files/download-retrieve.md) - File Storage > Common Models > Files [/files/{id}/download/request-meta](https://docs.merge.dev/merge-unified/filestorage/common-models/files/download-request-meta-retrieve.md) - File Storage > Common Models > Files [/files/download/request-meta](https://docs.merge.dev/merge-unified/filestorage/common-models/files/download-request-meta-list.md) - File Storage > Common Models > Files [/files/meta/post](https://docs.merge.dev/merge-unified/filestorage/common-models/files/meta-post-retrieve.md) - File Storage > Common Models > Folders [/folders](https://docs.merge.dev/merge-unified/filestorage/common-models/folders/list.md) - File Storage > Common Models > Folders [/folders/{id}](https://docs.merge.dev/merge-unified/filestorage/common-models/folders/retrieve.md) - File Storage > Common Models > Folders [/folders/meta/post](https://docs.merge.dev/merge-unified/filestorage/common-models/folders/meta-post-retrieve.md) - File Storage > Common Models > Groups [/groups](https://docs.merge.dev/merge-unified/filestorage/common-models/groups/list.md) - File Storage > Common Models > Groups [/groups/{id}](https://docs.merge.dev/merge-unified/filestorage/common-models/groups/retrieve.md) - File Storage > Common Models > Users [/users](https://docs.merge.dev/merge-unified/filestorage/common-models/users/list.md) - File Storage > Common Models > Users [/users/{id}](https://docs.merge.dev/merge-unified/filestorage/common-models/users/retrieve.md) - File Storage > Linked Account > Account details [/account-details](https://docs.merge.dev/merge-unified/filestorage/linked-account/account-details/retrieve.md) - File Storage > Linked Account > Account token [/account-token/{public_token}](https://docs.merge.dev/merge-unified/filestorage/linked-account/account-token/retrieve.md) - File Storage > Linked Account > Account token [/account-token/regenerate](https://docs.merge.dev/merge-unified/filestorage/linked-account/account-token/regenerate-create.md) - File Storage > Linked Account > Delete account [/delete-account](https://docs.merge.dev/merge-unified/filestorage/linked-account/delete-account/delete.md) - File Storage > Linked Account > Issues [/issues](https://docs.merge.dev/merge-unified/filestorage/linked-account/issues/list.md) - File Storage > Linked Account > Issues [/issues/{id}](https://docs.merge.dev/merge-unified/filestorage/linked-account/issues/retrieve.md) - File Storage > Linked Account > Linked accounts [/linked-accounts](https://docs.merge.dev/merge-unified/filestorage/linked-account/linked-accounts/list.md) - File Storage > Linked Account > Link token [/link-token](https://docs.merge.dev/merge-unified/filestorage/linked-account/link-token/create.md) - File Storage > Linked Account > Field Mapping [/field-mappings](https://docs.merge.dev/merge-unified/filestorage/linked-account/field-mapping/field-mappings-retrieve.md) - File Storage > Linked Account > Field Mapping [/field-mappings/{field_mapping_id}](https://docs.merge.dev/merge-unified/filestorage/linked-account/field-mapping/field-mappings-destroy.md) - File Storage > Linked Account > Field Mapping [/remote-fields](https://docs.merge.dev/merge-unified/filestorage/linked-account/field-mapping/remote-fields-retrieve.md) - File Storage > Linked Account > Field Mapping [/target-fields](https://docs.merge.dev/merge-unified/filestorage/linked-account/field-mapping/target-fields-retrieve.md) - File Storage > Linked Account > Available actions [/available-actions](https://docs.merge.dev/merge-unified/filestorage/linked-account/available-actions/retrieve.md) - File Storage > Data management > Scopes [/default-scopes](https://docs.merge.dev/merge-unified/filestorage/data-management/scopes/default-scopes-retrieve.md) - File Storage > Data management > Scopes [/linked-account-scopes](https://docs.merge.dev/merge-unified/filestorage/data-management/scopes/linked-account-scopes-retrieve.md) - File Storage > Data management > Force resync [/sync-status/resync](https://docs.merge.dev/merge-unified/filestorage/data-management/force-resync/sync-status-resync-create.md) - File Storage > Data management > Passthrough [/passthrough](https://docs.merge.dev/merge-unified/filestorage/data-management/passthrough/create.md) - File Storage > Data management > Async passthrough [/async-passthrough](https://docs.merge.dev/merge-unified/filestorage/data-management/async-passthrough/create.md) - File Storage > Data management > Async passthrough [/async-passthrough/{async_passthrough_receipt_id}](https://docs.merge.dev/merge-unified/filestorage/data-management/async-passthrough/retrieve.md) - File Storage > Data management > Sync status [/sync-status](https://docs.merge.dev/merge-unified/filestorage/data-management/sync-status/list.md) - File Storage > Org management > Generate key [/generate-key](https://docs.merge.dev/merge-unified/filestorage/org-management/generate-key/create.md) - File Storage > Org management > Regenerate key [/regenerate-key](https://docs.merge.dev/merge-unified/filestorage/org-management/regenerate-key/create.md) - File Storage > Org management > Audit trail [/audit-trail](https://docs.merge.dev/merge-unified/filestorage/org-management/audit-trail/list.md) - File Storage > selective-sync [Conditions List](https://docs.merge.dev/merge-unified/filestorage/selective-sync/conditions-list.md) - File Storage > selective-sync [Labels List](https://docs.merge.dev/merge-unified/filestorage/selective-sync/labels-list.md) - File Storage > selective-sync [Selections List](https://docs.merge.dev/merge-unified/filestorage/selective-sync/selections-list.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://docs.merge.dev/merge-unified/filestorage/openapi.json) - [OpenAPI YAML](https://docs.merge.dev/merge-unified/filestorage/openapi.yaml)