Developers

File transfers, built into your product

REST API, webhooks, and SDKs. Upload files, generate links and control access — programmatically.

View quickstart API pricing
Quickstart

Upload a file in 3 lines

Authenticate with an API key, upload your file, get a shareable link. That's it.

upload.js
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 expiry
  • faststnex_get_transfer: Check download counts, file lists, and status
  • faststnex_revoke_transfer: Kill recipient access immediately
  • faststnex_get_analytics: Inspect IP access history and download logs
mcp_config.json
{
  "mcpServers": {
    "faststnex": {
      "command": "php",
      "args": ["artisan", "mcp:serve"]
    }
  }
}