Links

List links

Lists links in the caller's workspace (the team, or the personal account), paginated, filterable and sortable. Each item is a full Link.

Auth: API key (Bearer flyn_sk_live_...) or an MCP OAuth access token (Bearer flyn_mcp_at_...). The dashboard session cookie is not accepted.

Plan: every plan. Any team role, including viewer.

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

Unrecognised status and sort values are ignored rather than rejected.

get/api/links

Request

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

Query parameters

pageinteger

Page number, floored at 1.

limitinteger

Items per page, clamped to 1..100.

status'active' | 'expired' | 'archived'

Filter by state. active: status active, not past its expiry date and not disabled by Flyn (a link that has used up its click limit still counts). expired: status set to expired or past its expiry date, and not archived. archived: archived. Any other value applies no filter.

searchstring

Case-insensitive substring match on slug, destination and title. Double quotes and backslashes are stripped; cut to 100 characters.

tagstring

Only links carrying this exact tag.

folder_idstring uuid

Only links in this folder.

sort'created_at' | 'clicks' | 'slug' | 'title'

Sort column; anything else falls back to created_at.

order'asc' | 'desc'

asc sorts ascending; any other value sorts descending.

Response

The page of links.

Changes

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