Developers
File transfers, built into your product
REST API, webhooks, and SDKs. Upload files, generate links and control access — programmatically.
Quickstart
Upload a file in 3 lines
Authenticate with an API key, upload your file, get a shareable link. That's it.
import FastSTNex from '@faststnex/sdk';
const client = new FastSTNex({
apiKey: 'stn_live_your_api_key'
});
// Upload and generate instant encrypted transfer
const transfer = await client.transfers.create({
files: ['./contract.pdf'],
security: {
mode: 'pin',
pin: '123456'
},
expiresIn: '7d',
downloadLimit: 10
});
console.log(transfer.shareUrl);
// → https://faststnex.com/s/Ab7X92Kd
# Response payload
{
"id": "txr_Ab7X92Kd",
"shareUrl": "https://faststnex.com/s/Ab7X92Kd",
"files": [{ "name": "contract.pdf", "size": 224512 }],
"security": { "mode": "pin" },
"expiresAt": "2026-09-20T03:26:37Z",
"status": "active"
}
API Reference
Core endpoints
POST
/api/v1/shares
Create a new encrypted transfer
Docs →
GET
/api/v1/shares/{token}
Retrieve transfer metadata & files
Docs →
POST
/api/v1/shares/{token}/verify-pin
Validate PIN for protected package
Docs →
POST
/api/v1/shares/{token}/revoke
Revoke / delete active transfer
Docs →
GET
/api/v1/shares/{token}/download/{fileId}
Stream / download decrypted file
Docs →
Webhooks
Get notified in real-time when transfers are created, viewed, downloaded or revoked.
{
"event": "transfer.downloaded",
"transfer": "txr_Ab7X92Kd",
"file": "contract.pdf",
"ip": "203.0.113.1",
"at": "2026-09-20T03:26:37Z"
}
Official SDKs
Drop-in packages maintained directly by our core engineering team.
Node.js
npm install @faststnex/sdk
Python
pip install faststnex-sdk
PHP
composer require faststnex/sdk
Go
go get faststnex.com/sdk
AI Integration
Model Context Protocol (MCP) Server
Connect AI assistants directly to your FastSTNex file sharing engine over stdio JSON-RPC.
FastSTNex provides a native Model Context Protocol (MCP) server that empowers Claude, ChatGPT, Antigravity, and Cursor agents to perform file operations autonomously:
faststnex_create_transfer: Generate links with PIN, AES-256, and expiryfaststnex_get_transfer: Check download counts, file lists, and statusfaststnex_revoke_transfer: Kill recipient access immediatelyfaststnex_get_analytics: Inspect IP access history and download logs
mcp_config.json
{
"mcpServers": {
"faststnex": {
"command": "php",
"args": ["artisan", "mcp:serve"]
}
}
}