API Reference

Manage Furl programmatically.

A tRPC procedure reference for domain workspaces, hostnames, routes, redirects, files, A/B tests, and analytics. Queries use GET and mutations use POST.

Authentication

Every request must include your API key as a Bearer token in the Authorization header. Keys are scoped to your team and can be created in Dashboard → Settings → API. For raw HTTP calls, follow tRPC's HTTP format and pass aninputpayload that matches the procedure schema.

curl "https://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/routes.list?input=%7B%22domainId%22%3A%22dom_123%22%7D" \
  -H "Authorization: Bearer furl_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

Domain Workspaces

GEThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/domains.list

List domain workspaces for a team.

ParameterTypeRequiredDescription
teamIdstringYesTeam identifier.
POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/domains.create

Create a domain workspace.

ParameterTypeRequiredDescription
teamIdstringYesTeam identifier.
namestringYesWorkspace display name.
primaryOriginstringYesPrimary upstream origin URL.
primaryPlatformstringYesPlatform preset (webflow, ghost, shopify, etc.).
GEThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/domains.get

Get one domain workspace with hostname and route counts.

ParameterTypeRequiredDescription
domainIdstringYesDomain workspace identifier.
POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/domains.update

Update workspace metadata or primary origin settings.

POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/domains.delete

Delete a domain workspace.

Hostnames

GEThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/hostnames.list

List hostnames attached to a domain workspace.

POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/hostnames.create

Add a hostname (primary, alias, redirect). Wildcard hostnames are scheduled for Q2 2026 GA.

POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/hostnames.verify

Run DNS verification for a hostname.

GEThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/hostnames.getDnsRecords

Fetch DNS records required for verification.

POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/hostnames.delete

Delete a hostname from a domain workspace.

Routes

GEThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/routes.list

List routes for a domain workspace.

POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/routes.create

Create a route rule (subfolder path proxying).

ParameterTypeRequiredDescription
domainIdstringYesDomain workspace identifier.
pathstringYesPublic path prefix, e.g. /blog.
destinationUrlstringYesDestination origin URL.
platformstringYesPlatform preset for routing defaults.
POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/routes.update

Update route path, destination, platform, or status.

POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/routes.reorder

Reorder route matching priority.

POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/routes.delete

Delete a route.

Redirects, Files, A/B, Analytics

POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/redirects.create

Create redirect rules (301/302, wildcard/regex supported).

POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/files.getUploadUrl

Request a signed upload URL for R2 file uploads.

POSThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/abTests.create

Create an A/B test for a domain workspace.

GEThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/analytics.summary

Get summary analytics for a domain workspace and period.

GEThttps://furl-api-staging.hexeldigitalstudio.workers.dev/trpc/analytics.topPages

Get top page paths for a domain workspace and period.

Rate limits

API requests are rate-limited per team. Limits reset every 60 seconds. Exceeding the limit returns a 429 Too Many Requests with a Retry-After header.

Starter60 req / min
Growth300 req / min
Agency1,000 req / min
EnterpriseCustom