API Reference

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

Upload, update, delete, and serve files.

Manage custom domains for your uploads.

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) 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