Skip to content

Unified API

Unified File Storage API

One standardized interface to read and write cloud storage data across every provider. 10 unified resources, 9 supported integrations, zero provider-specific code.

https://api.truto.one/unified/file-storage
Start integrating API docs
10

Unified resources

9

Supported integrations

Pass‑through

Real-time, no data storage

Data Model

File Storage resources

Every resource is normalized across providers. Use the same schema whether your customer is on Box or Dropbox - Business.

Drive-items

Drive Items are the files and folders present in a file storage system. These items are usually part of a Drive. You can differentiate between files and folders using the type attribute.

16 fields Docs →
Drive-items fields
id string
name string
public_url string
path string
urls array
type string
has_children boolean
size integer
mime_type string
description string
parent object
drive object
creator object
tags array
created_at string
updated_at string

Drives

Drives is a collection of files and folders. They could have multiple Drive Items within them. Users could have multiple Drives accessible to them in a file storage system.

7 fields Docs →
Drives fields
id string
name string
workspace object
drive_url string
path string
created_at string
updated_at string

Files

[DEPRECATED] The file represent a file in File Storage.

11 fields Docs →
Files fields
id string
name string
file_url string
file_thumbnail_url string
size integer
mime_type string
description string
folder string
drive string
created_at string
updated_at string

Folders

[DEPRECATED] The folder represent a folder in File Storage.

9 fields Docs →
Folders fields
id string
name string
folder_url string
size integer
description string
parent_folder string
drive string
created_at string
updated_at string

Groups

Groups represent a collection of users. They could be grouped based on departments, projects, permissions, etc.

4 fields Docs →
Groups fields
id string
name string
created_at string
updated_at string

Permissions

Permissions can answer your questions around which User has access to do what on a Drive Item or a Drive.

4 fields Docs →
Permissions fields
id string
resources array
user object
permissions array

Tags

Represents the tags in a file storage system

6 fields Docs →
Tags fields
id string
name string
description string
options array
created_at string
updated_at string

Users

Users represent the people using the underlying file storage system.

8 fields Docs →
Users fields
id string
first_name string
last_name string
name string
emails array
roles array
created_at string
updated_at string

Webhooks

0 fields Docs →
Webhooks fields

Workspaces

Workspaces represent the top-level subdivision in a file storage system. They usually have their own set of drives, groups and users. Some of the usual terminologies used by the products for the top-level subdivision are projects, bases, spaces, workspace, etc.

4 fields Docs →
Workspaces fields
id string
name string
created_at string
updated_at string

Integrations

9 integrations, one API

Connect to any of these providers through the Unified File Storage API. Same resources, same schema, same code.

How It Works

From zero to integrated

Go live with the Unified File Storage API in under an hour. No boilerplate, no maintenance burden.

01

Connect your customer’s account

Use Truto’s pre-built auth flows to connect any cloud storage provider. OAuth, API keys, and custom auth — all handled.

02

Query the unified API

Read and write data through a single, normalized REST API. Same endpoints, same schema, regardless of the underlying provider.

03

Customize with JSONata

Need a field the unified model doesn’t cover? Extend the schema with declarative JSONata mappings — no code deploys, no waiting on us.

Unified File Storage API

Start building with the Unified File Storage API

9 integrations. 10 unified resources. Zero provider-specific code. Ship cloud storage integrations in hours, not months.

Talk to us