Links

Create many links to one destination

Link multiplier: creates 2 to 50 short links to the same destination in one atomic insert, all carrying one batch tag. No link.create webhooks are sent for these links.

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. The viewer team role gets 403.

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

post/api/links/bulk-create

Request

  • Base URL: https://www.flyn.to
  • URL: https://www.flyn.to/api/links/bulk-create
  • Auth: HTTP bearer

Request body

urlstring required

Shared destination. Same rules as POST /api/links (https:// prepended, mailto:, tel: and sms: accepted, ftp refused, host with a dot, not a Flyn host, public DNS). One safety scan covers the batch (422).

quantityinteger required

How many links. Floored first, so 2.9 becomes 2; numeric strings are accepted.

tagstring

Batch tag. Trimmed and cut to 50 characters. Default batch-<6 random characters>.

titlestring

Shared title. Trimmed and cut to 200 characters. Default: the part of the URL after // up to the next / (usually the hostname, but it keeps any port or userinfo, and a query or fragment when there is no path), else "Untitled".

domainstring

Default: the current Flyn short domain; the legacy value www.flyn.to is treated as a request for that default. Any other value must be a custom domain owned by the workspace, else 403.

Response

The batch was created.

createdinteger required
tagstring required
urlstring required

Changes

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