API Documentation

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

Authentication

Include your Client ID in the x-client-id header and your API Token as a Bearer token in the Authorization header. Generate keys in your dashboard settings.

x-client-id: snst_client_...
Authorization: Bearer snst_...

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"
}