API Reference

The Emberly REST API lets you upload files, shorten URLs, manage metadata, and configure custom domains from any language or tool.

Upload, update, delete, and serve files.

Create and manage short links.

Manage custom domains for your uploads.

Storage stats, top files, and activity data.

Manage security, tokens, linked accounts, and perks.

Nexium profiles, squads, opportunities, and applications.

Comprehensive reference for all user-facing endpoints.

Admin-only endpoints for user management and moderation.

Base URL

https://embrly.ca/api

All endpoints require a Bearer token:

Authorization: Bearer YOUR_UPLOAD_TOKEN

Get your token from Dashboard → Settings → Profile → Upload Token.

Some endpoints (domains, profile, analytics) require a session cookie from a browser login rather than a token. These are noted per-endpoint.

All responses return JSON:

{
  "success": true,
  "data": { ... }
}

Error responses:

{
  "success": false,
  "error": "Human-readable error message"
}

Plan	Upload rate	API rate
Spark (free)	10 req/min	60 req/min
Paid plans	Higher limits based on tier	Higher limits

Exceeding limits returns 429 Too Many Requests.

Code	Meaning
`200`	Success
`400`	Bad request — see `error` field
`401`	Unauthenticated
`403`	Forbidden (insufficient permissions or unverified resource)
`404`	Resource not found
`409`	Conflict (duplicate, already exists)
`413`	File too large or quota exceeded
`429`	Rate limited
`500`	Server error