POST /site/domain
Updated Oct 1, 20261 minute read
Connect a custom domain
Connects a hostname like help.example.com, replacing any other. Add the returned records at your DNS provider; the domain goes live once they are in place. Needs the Site add-on or Pro. Admins and owners only.
Part of Site.
Request body
application/json, required.
| Field | Type | Required | Description |
|---|---|---|---|
domain | string | Yes |
Responses
| Status | Description |
|---|---|
200 | The domain, with the records to add. |
401 | The bearer token is missing, revoked, or expired. |
429 | Too many requests. Wait the seconds in Retry-After. Limits depend on the plan. See rate limits. |
200 body
| Field | Type | Required | Description |
|---|---|---|---|
domain | object | null | No |
Example request
curl -X POST https://api.median.sh/v1/site/domain \
-H "Authorization: Bearer $BEARER_AUTH"