Thylink developer documentation
Thylink exposes a JSON REST API to create and manage profiles, links, videos and events from other services, plus a set of files that let an automated agent understand the site without scraping it.
API reference
The full reference lists every endpoint with its parameters, responses and error codes: registration and login, profiles, custom links, social links, YouTube videos, events, analytics and token management.
API base URL:
https://thyl.ink/api
Authentication
The API uses Laravel Sanctum bearer tokens. Get one with POST /api/auth/login or POST /api/auth/register and send it on every request in the Authorization: Bearer {token} header. Tokens are listed, created and revoked from /api/tokens.
Rate limits
Public authentication and SSO routes allow 10 requests per minute. Every other authenticated route allows 100 requests per minute. Going over either one returns 429.
Files for agents
These paths are stable and meant for automated consumption:
- /openapi.json — OpenAPI 3.1 specification generated from the API routes; never hand-written.
- /llms.txt — Site summary and entry map in llms.txt format.
- /agent-instructions.md — When to use Thylink, which questions it answers and how to call it.
- /sitemap.xml — Every indexable URL with its last modification date.
- /robots.txt — Crawl rules and the sitemap location.
Any public page returns Markdown when requested with the Accept: text/markdown header; negotiated responses carry Vary: Accept.
curl -H "Accept: text/markdown" https://thyl.ink