Developer API

Integrate Sensory directly into your build pipelines, CLI tools, and applications. Our API is designed for speed, isolation, and zero-trust asset mirroring.

Generate API Key

One-time generation

An API key enables File Isolation. Any file uploaded with this key is hidden from the public grid and only accessible when the same key is provided during download.

Sensory does not store your plaintext keys. Keep this safe.

Quick Start

Upload files directly from your terminal using cURL. Include the x-api-key header to isolate your mirror in a private namespace.

Bash / cURL

curl -X POST https://mirror.sdad.pro/api/upload \
  -H "x-api-key: your-api-key" \
  -F "file=@asset.png" \
  -F "ttl=7d"

CDN & Delivery Profiles

Sensory processes every request through our high-speed edge grid. Choose the profile that matches your application's visibility needs.

Standard Public

Globally cacheable, unauthenticated delivery. 1-year browser/edge TTL.

/files/[slug]

Requires: None

Isolated Namespace

API-only isolation. Invisible to the grid. High-speed delivery via Key verification.

/files/[slug]

Requires: x-api-key header

Dual-Layer Private

Max security. Requires both Signed Token and Key (if isolated).

/files/[slug]?token=...

Requires: Token + Optional Key

Core Endpoints

POST/api/upload

Standard file upload. Supports multi-part form data.

Parameters (form-data)

file(File)— The asset to mirror (binary)

ttl(String)— 1h, 24h, 7d, or permanent

access(String)— public (default) or private

Headers

x-api-key— Optional. Your secure key for isolation.

GET/files/[slug]

Download mirrored asset. Requires key if isolated.

Headers

x-api-key— Required only for isolated assets.