Overview
A FrameRelay workspace holds your projects, people and media. Inside a project you can open live review rooms, upload and share files, and sync folders between workstations with the agent.
Workspaces are invite-only. Someone has to invite you, or your request for access has to be approved, before you can sign in.
Joining a workspace
- Open the invite email and copy the code. It looks like
FR-7K2Q-91XDand is valid for 7 days. - Go to framerelay.xyz/invite and enter the code.
- Confirm your email. From then on you sign in with a one-time link, so there's no password to forget.
Desktop app and agent
The desktop app hosts live rooms and manages uploads. It installs the sync agent, a background service that starts with the system and keeps one connection open to the nearest edge.
- macOS 12 or later, Apple silicon or Intel
- Windows 10 or 11, x64 or ARM64
- Ubuntu 22.04+, Debian 12+, Fedora 39+
Signed-in members of a workspace can download it from the download page. Updates install automatically in the background.
Network requirements
FrameRelay only needs outbound TCP 443. Allow the following hosts on your studio firewall or proxy:
| Host | Port | Protocol | Used for |
|---|---|---|---|
framerelay.xyz | 443 | HTTPS | Web app, sign-in, invites |
static.framerelay.xyz | 443 | HTTPS | Scripts, fonts, images |
api.framerelay.xyz | 443 | HTTPS | Auth, projects, comments, events |
edge.framerelay.xyz | 443 | TLS 1.3 over TCP | Live rooms, sync agent connection |
cdn.framerelay.xyz | 443 | HTTPS | Uploads, downloads, review links |
TLS inspection
The desktop app and the agent pin FrameRelay's certificates. If your firewall decrypts and re-signs TLS traffic, connections to edge.framerelay.xyz and cdn.framerelay.xyz will fail. Add all five hosts to the inspection bypass list.
Long-lived connections
Edge connections stay open for hours, sometimes days, and carry a steady stream of data. Set idle timeouts on proxies and NAT gateways to at least 60 minutes. The agent sends a heartbeat every 30 seconds, so a healthy connection is never truly idle.
Bandwidth guide
Live rooms adapt to the slowest reviewer. These are the figures to plan around per connection:
| Activity | Typical | Peak |
|---|---|---|
| Live room, 4K 10-bit | 25–35 Mbps | 50 Mbps |
| Live room, 1080p 10-bit | 8–12 Mbps | 18 Mbps |
| Reviewer audio and camera | 0.5–1.5 Mbps | 2.5 Mbps |
| Sync agent, active project | 20–200 GB/day | Your limit |
| Sync agent, idle | <1 MB/hour | — |
To cap the agent, open Settings → Bandwidth and add a schedule. Limits apply per workstation.
API overview
The REST API lets you automate projects, uploads and review links. All requests go to:
https://api.framerelay.xyz/v2
Requests and responses are JSON. Timestamps are ISO 8601 in UTC. Every response carries an x-request-id header; include it when you contact support.
Authentication
Create a token in Workspace settings → API. Tokens are scoped to one workspace and can be read-only.
curl https://api.framerelay.xyz/v2/projects \ -H "Authorization: Bearer fr_live_••••••••••••"
Requests without a valid token get 401:
{ "error": "unauthorized", "message": "Missing or invalid bearer token" }
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /v2/projects | List projects in the workspace |
| GET | /v2/projects/:id/assets | List assets in a project |
| POST | /v2/uploads | Start a resumable upload, returns part URLs on cdn |
| POST | /v2/review-links | Create a signed review link |
| DELETE | /v2/review-links/:id | Revoke a review link everywhere |
| GET | /v2/rooms | List active live rooms |
| GET | /v2/events | Server-sent event stream for the workspace |
Rate limits
Each token can make 600 requests per minute. Over the limit you get 429 with a Retry-After header. Upload part requests to cdn.framerelay.xyz don't count toward the limit.
Webhooks
Register an HTTPS endpoint in Workspace settings → Webhooks. We send asset.ready, comment.created, room.started, room.ended and link.viewed. Every request is signed with HMAC-SHA256 in the x-fr-signature header.
# verify a webhook signature expected = hmac_sha256(secret, timestamp + "." + raw_body)