Domains

Add a custom domain

Creates a pending custom domain and returns the DNS records to publish. The domain is not attached for serving yet; POST /api/domains/{id}/verify does that once the TXT record is in place. Also reachable as POST /api/domains, with the same body, responses and rate-limit bucket.

Auth: API key (Bearer flyn_sk_live_...), or the signed-in dashboard session cookie when no API key header is sent. MCP OAuth access tokens are not accepted here and get 401.

Plan: Pro, Lifetime or Team (a member of a paying owner's workspace has the effective plan team) only; Free gets 403 UPGRADE_REQUIRED before the body is read. At most 3 domains per workspace (400 LIMIT_REACHED, checked before body validation).

Rate limit: 10 requests per 60 s per client IP, fixed window, in memory per server instance, checked before authentication.

post/api/domains/add

Request

  • Base URL: https://www.flyn.to
  • URL: https://www.flyn.to/api/domains/add
  • Auth: HTTP bearer

Request body

domainstring required

Domain or subdomain you own. Lower-cased; a leading http(s):// and www. and trailing slashes are stripped. Must contain a dot and match ^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,}$. Flyn domains and well-known public platforms are refused. A non-string value returns 500.

Response

Created. Publish the TXT record, add the routing record, then call verify.

Changes

No recorded changes to this operation across all 1 revision of this API.