API Documentation

Integrate sonest subdomain management into your build pipelines and CLI tools.

Authentication

Include your API key as a Bearer token in the Authorization header. Generate keys in your dashboard settings.

Authorization: Bearer YOUR_API_TOKEN

Endpoints

GET/api/subdomains

List all subdomains under your account.

{
  "subdomains": [
    {
      "id": "sub_1g8a97h1a",
      "name": "my-app",
      "domain": "snst.lol",
      "createdAt": "2026-07-06T18:23:10Z"
    }
  ]
}

POST/api/subdomains

{
  "name": "new-project",
  "domainId": "snst-lol-id"
}