---
title: "Suggest a random, currently-available subdomain"
method: GET
path: "/sites/suggest-subdomain"
tags: ["Sites"]
---

# Suggest a random, currently-available subdomain

`GET /sites/suggest-subdomain`

## Request

- Base URL: `https://api.nippy.host`
- URL: `https://api.nippy.host/sites/suggest-subdomain`
- Auth: none declared

Returns a Reddit-style adjective-noun name that is free right now, for prefilling the new-site form and the re-roll button. Numberless first, falling back to a numeric suffix only when needed.

## Response `200`

A suggested available subdomain

- APISuggestSubdomainResponse
  - `subdomain` string, required: A randomly generated, currently-available subdomain (adjective-noun, with a numeric suffix only if needed to avoid a collision)

---

[API](https://skmtc.dev/nippy/apis/nippy-backend-api.md) · [All operations](https://skmtc.dev/nippy/apis/nippy-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nippy/apis/nippy-backend-api/revisions/7ab23f040a55?raw)