The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Sitey — free subdomains listing page.
Free subdomain service for developers. Get a subdomain in seconds — no credit card, no hassle.
| Owner | Period | Reminders |
|---|---|---|
| Signed-in user | 3 months | 14 days, 3 days and the day it expires |
| API key / agent | 1 month | none — expires_at comes back with every read |
Renewing resets the clock from today. A subdomain that stops loading is not removed: we write to tell you it has gone dark, and that is all.
Programmatic access for developers and AI agents.
Base URL: https://sitey.my/api/v1
sitey.one and the www. hosts redirect here (308 for /api/*, so POST bodies survive).
| Mode | Auth | Limit |
|---|---|---|
| Anonymous | None (IP-based) | 3 subdomains |
| API key | Authorization: Bearer styo_xxx | Unlimited |
Get an API key: sign in at sitey.my → Dashboard → API Keys.
| Method | Path | Description |
|---|---|---|
| GET | /domains | List available root domains |
| GET | /check/:subdomain/:domain | Check availability |
| POST | /subdomains | Create A or CNAME record |
| GET | /subdomains | List your subdomains |
| PATCH | /subdomains/:sub/:domain | Update record value |
| DELETE | /subdomains/:sub/:domain | Delete subdomain |
| POST | /subdomains/:sub/:domain/renew | Extend before expires_at |
| POST | /subdomains/:sub/:domain/txt | Create/update TXT record |
| DELETE | /subdomains/:sub/:domain/txt/:prefix | Delete TXT record |
AI agents can use free-domain-mcp — an MCP server that wraps this REST API.
named-checkzone validates → systemctl reload named appliesWe run our own authoritative nameservers (ns1.sitey.one, ns2.sitey.one) — no third-party DNS provider.
myapp.sitey.my