Skip to main content

What is a Unified API?

A unified API provides a single, standardized interface to interact with multiple third-party providers. Instead of learning each provider’s unique API format, authentication scheme, and data model, you write code once, and StackOne handles the differences. What StackOne normalizes:
  • Data models – Consistent field names and structures across providers (e.g., files in Google Drive, SharePoint, and Dropbox all return the same schema; users in Google Workspace, Okta, and 1Password all return the same schema)
  • Authentication – OAuth, API keys, and tokens are managed per-provider; you just pass an x-account-id header
  • Pagination – Cursor-based pagination works the same regardless of whether the provider uses offsets, pages, or cursors
  • Error formats – Standardized error responses with provider-specific details when available
Building AI agents? Use MCP Servers or AI Toolset SDKs instead. Same underlying data, optimized for LLM tool calling with built-in context management.
StackOne Documents API Interface

Benefits of the Documents API

Built for easily syncing files, in real-time from multiple providers. Use the api to access nested folders & files data in a simple and unified way, regardless of the underlying provider.
One File Picker SDK that lets your users pick files from multiple providers, with a single call to the SDK and get back picked files & folders the same way regardless of the provider.
StackOne’s APIs support real-time synchronization, ensuring that content changes are reflected immediately across connected platforms.
With a focus on security, StackOne ensures secure content storage and maintains compliance with data protection regulations.
The platform provides both synthetic and native webhooks, delivering real-time notifications for changes in drives, folders, and files.
StackOne offers pre-built connectors with leading File Management platforms, simplifying the integration process.

StackOne SDKs & OpenAPI Specification

Use our official SDKs for faster integration. Build with language-native libraries. Full list here.

OpenAPI Specification

Entity Model

The Documents API is built around three entities: drives, folders, and files.
EntityDescription
DriveThe top-level container — a storage volume, shared drive, or knowledge base space. Each drive can contain folders and files directly.
FolderA named container within a drive. Folders can nest inside other folders and track their parent (parent_folder_id) and owning drive (drive_id).
FileA document or content item. Files carry metadata about format (file_format), available export types (export_formats), and the default format used when downloading (default_download_format).
Field availability varies by integration provider. Optional fields may be null if the provider’s API does not expose them. See your connector’s integration guide for coverage details.

File formats

The file_format field uses a normalized enum across providers. Common values include pdf, docx, xlsx, pptx, html, csv, png, jpg, and unknown. The export_formats array lists the MIME types available when downloading a file, and default_download_format is the format used when no export format is specified.