---
title: "Generate a random available subdomain"
method: POST
path: "/v1/hosting/websites/subdomain/generate"
tags: ["Subdomain"]
---

# Generate a random available subdomain

`POST /v1/hosting/websites/subdomain/generate`

## Request

- Base URL: `https://api.10web.io`
- URL: `https://api.10web.io/v1/hosting/websites/subdomain/generate`
- Auth: none declared. Required headers: `x-api-key`
- TypeScript: <https://skmtc.dev/10web/apis/10web-api-v1/docs/v1/hosting/websites/subdomain/generate/post.ts> (a function with typed inputs; its response is checked against the schema)

## Headers

- `x-api-key` string, required

## Response `200`

Generated subdomain result

- object
  - `status` 'ok' | 'error'
  - `subdomain` string: The generated subdomain

## Other responses

- `403`: Unauthorized access
- `429`: Too many requests
- `500`: Something went wrong

---

[API](https://skmtc.dev/10web/apis/10web-api-v1.md) - [All operations](https://skmtc.dev/10web/apis/10web-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/10web/apis/10web-api-v1/revisions/01afc9651dfc?raw)