Ship uploads fast with a clean API-key SDK.

from vaultsens_sdk import VaultSensClient

client = VaultSensClient(
    base_url='https://api.vaultsens.com',
    api_key='fs_123',
    api_secret='sk_456',
)

# Swap credentials at runtime
client.set_auth('fs_new', 'sk_new')

<?php

use VaultSens\VaultSensClient;

$client = new VaultSensClient(
    'https://api.vaultsens.com',
    'fs_123',
    'sk_456'
);

// Swap credentials at runtime
$client->setAuth('fs_new', 'sk_new');

# List all files
files = client.list_files()

# List files in a folder
files = client.list_files(folder_id='folder_id')

# Get metadata for one file
meta = client.get_file_metadata('file_id')
print(meta['data']['url'], meta['data']['size'])

# Delete a file
first = files['data'][0] if files['data'] else None
if first:
    client.delete_file(first['id'])

// List all files
$list = $client->listFiles();

// List files in a folder
$list = $client->listFiles('folder_id');

// Get metadata for one file
$meta = $client->getFileMetadata('file_id');
echo $meta['data']['url'];

// Delete a file
$first = $list['data'][0] ?? null;
if ($first) {
    $client->deleteFile($first['id']);
}

result = client.update_file(
    'file_id',
    './new-hero.png',
    name='hero-v2',
    compression='high',
)
print(result['data']['url'])

$result = $client->updateFile(
    'file_id',
    './new-hero.png',
    'hero-v2', // name (optional)
    'high'     // compression (optional)
);
echo $result['data']['url'];

# List all folders
result = client.list_folders()
folders = result['data']

# Create a top-level folder
result = client.create_folder('Marketing')
folder_id = result['data']['id']

# Create a nested folder
client.create_folder('2024', parent_id=folder_id)

# Rename
client.rename_folder(folder_id, 'Campaigns')

# Delete an empty folder
client.delete_folder(folder_id)

// List all folders
$result  = $client->listFolders();
$folders = $result['data'];

// Create a top-level folder
$result   = $client->createFolder('Marketing');
$folderId = $result['data']['id'];

// Create a nested folder
$client->createFolder('2024', $folderId);

// Rename
$client->renameFolder($folderId, 'Campaigns');

// Delete an empty folder
$client->deleteFolder($folderId);

# No transforms — original URL
url = client.build_file_url('file_id')

# Resize and convert to WebP
thumb = client.build_file_url(
    'file_id',
    width=800,
    format='webp',
    quality=80,
)
print(thumb)

// No transforms — original URL
$url = $client->buildFileUrl('file_id');

// Resize and convert to WebP
$thumb = $client->buildFileUrl('file_id', [
    'width'   => 800,
    'format'  => 'webp',
    'quality' => 80,
]);
echo $thumb;

result = client.get_metrics()
data = result['data']

print(data['totalFiles'])          # e.g. 142
print(data['totalStorageBytes'])   # e.g. 524288000
print(data['storageUsedPercent'])  # e.g. 48
print(data['storageRemainingBytes'])
print(data['byMimeType'])          # {'image/png': 80, ...}

$result = $client->getMetrics();
$data   = $result['data'];

echo $data['totalFiles'];          // e.g. 142
echo $data['totalStorageBytes'];   // e.g. 524288000
echo $data['storageUsedPercent'];  // e.g. 48
echo $data['storageRemainingBytes'];
print_r($data['byMimeType']);      // ['image/png' => 80, ...]

from vaultsens_sdk import VaultSensClient, VaultSensError

try:
    client.upload_file('./photo.png')
except VaultSensError as err:
    print(err.status, err.code, err.message)

    if err.code == 'FILE_TOO_LARGE':
        print('File exceeds your plan limit')
    elif err.code == 'STORAGE_LIMIT':
        print('Storage quota exceeded')
    elif err.code == 'SUBSCRIPTION_INACTIVE':
        print('Upgrade your plan to continue')
    elif err.code == 'MIME_TYPE_NOT_ALLOWED':
        print('File type not allowed on your plan')

use VaultSens\VaultSensError;

try {
    $client->uploadFile('./photo.png');
} catch (VaultSensError $err) {
    echo $err->getCode() . ' ' . $err->errorCode . ' ' . $err->getMessage();

    switch ($err->errorCode) {
        case VaultSensError::FILE_TOO_LARGE:
            echo 'File exceeds your plan limit';
            break;
        case VaultSensError::STORAGE_LIMIT:
            echo 'Storage quota exceeded';
            break;
        case VaultSensError::SUBSCRIPTION_INACTIVE:
            echo 'Upgrade your plan to continue';
            break;
        case VaultSensError::MIME_TYPE_NOT_ALLOWED:
            echo 'File type not allowed on your plan';
            break;
    }
}

client = VaultSensClient(
    base_url='https://api.vaultsens.com',
    api_key='fs_xxx',
    api_secret='sk_xxx',
    timeout=30,  # seconds
)

$client = new VaultSensClient(
    'https://api.vaultsens.com',
    'fs_xxx',
    'sk_xxx'
);