Remove custom domain

Detach the custom hostname from a hosted static website.

← All Pages endpoints · Capability overview

DELETE/v1/pages/{page_id}/custom-domain

https://api.vee3.io/v1/pages/{page_id}/custom-domain

5 tokens

Detach the custom hostname from a hosted static website.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

pages.remove_custom_domain

Parameters1 field

page_idstringRequired

Page id to detach the custom domain from.

Response10 fields

page_idstring

Unique identifier for the page.

namestring

Display name for the page, if set.

slugstring

Page slug.

statusstring

Current page status.

urlstring

Public HTTPS URL for the page. Uses the custom domain when one is attached.

hostnamestring

Preview hostname ({slug}.vee3.site). Always present, including when a custom domain is attached.

custom_domainstring

Custom hostname attached to the page, if any.

created_atstring

When the page was created.

updated_atstring

When the page record was last updated.

last_deployed_atstring

When files were last deployed to the page.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, page_not_found

Example request

Python

import requests

url = "https://api.vee3.io/v1/pages/{page_id}/custom-domain"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
payload = {
    "page_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Page details after removing a custom domain.

custom_domain_removed.json

{
  "page_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Docs",
  "slug": "docs",
  "status": "active",
  "url": "https://docs.vee3.site",
  "hostname": "docs.vee3.site",
  "custom_domain": null,
  "created_at": "2026-08-11T12:00:00.000Z",
  "updated_at": "2026-08-31T14:45:00.000Z",
  "last_deployed_at": "2026-08-11T12:05:00.000Z"
}