sitey-my

sitey-my Subdomains API

The Subdomains API from sitey-my — 6 operation(s) for subdomains.

GitHub OpenAPI

Operations 8

POST /api/v1/subdomains Claim a name and point it somewhere #
GET /api/v1/subdomains What this caller holds #
PATCH /api/v1/subdomains/{subdomain}/{domain} Point an existing name somewhere else #
DELETE /api/v1/subdomains/{subdomain}/{domain} Give a name back #
POST /api/v1/subdomains/{subdomain}/{domain}/renew Keep a name for another period #
POST /api/v1/subdomains/{subdomain}/{domain}/extend Keep a name for a year, for 1.00 USDC #
POST /api/v1/subdomains/{subdomain}/{domain}/txt Add the TXT record a host asks for #
DELETE /api/v1/subdomains/{subdomain}/{domain}/txt/{hostPrefix} Take that TXT record away #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/sitey-my/openapi/sitey-my-subdomains-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/sitey-my/json-schema/sitey-my-subdomain-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/sitey-my:sitey-my-subdomains-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

sitey-my-subdomains-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Sitey Subdomains API
  version: 1.0.0
  summary: 'Free subdomains with the DNS behind them: claim a name, point it at an address with an A or CNAME record, or send its visitors to a URL with a REDIRECT record, and add the TXT record a host asks for. Over REST or MCP, with or without an account.'
  description: 'Free subdomains with the DNS behind them: claim a name, point it at an address with an A or CNAME record, or send its visitors to a URL with a REDIRECT record, and add the TXT record a host asks for. Over REST or MCP, with or without an account.


    Limits:

    - An account may hold 5 subdomains and is refused the next one.

    - A caller with no API key is identified by an owner token. Creating without one mints it and returns it once, so nothing has to be fetched or signed up for first; send it back to manage the record from any address, and note that it cannot be looked up again. Records created before tokens existed are still identified by the IP address that made them. Either way the 5 is enforced, per token or per address.

    - Without an account (an API key from the dashboard) three things are refused: TXT records (ACCOUNT_REQUIRED); a CNAME or REDIRECT pointing at a temporary tunnel — trycloudflare.com, serveousercontent.com, serveo.net, ngrok.io, ngrok.app, ngrok-free.app, ngrok-free.dev, loca.lt, localtunnel.me, pinggy.link, pinggy.io, lhr.life, localhost.run, bore.pub, devtunnels.ms, tunnelmole.net — (TUNNEL_TARGET_FORBIDDEN); and names containing login, signin, verify, wallet, password, recovery, support, security, account, auth, bank (ACCOUNT_REQUIRED). An API key lifts all three. Brand names (toss, kakao, paypal and the like) are refused for everyone.

    - A name is lent, not given: 3 months for a record owned by an account, 1 month for one created without one. Every response carries expires_at, and renewal opens 14 days before it.

    - A record nobody renews is removed on that date.

    - Nothing can be bought while the payment route is off: a caller who is refused is refused, not offered a price.

    - A record created without an account is renewed free a month at a time. Paying for a year is switched off on this server.


    The same operations are available to an agent runtime over MCP at https://sitey.my/mcp (Streamable HTTP, one POST per message); https://sitey.my/.well-known/mcp.json describes it.'
servers:
- url: https://sitey.my
security:
- {}
- apiKey: []
- ownerToken: []
tags:


# --- truncated at 32 KB (34 KB total) ---
# Full source: https://artifacts.apis.io/sitey-my/openapi/sitey-my-subdomains-api-openapi.yml