DELETE
/service/@id/builder/sites/@site/domains/@hostnameRemove a custom domain
Removes the domain from the website. Returns {"removed": true}. Send idempotency_key in the query.
TinoPage Builder API · Updated 2026-10-26View .md
A TinoPage Builder service route: call it with the service owner's sign-in token; the /v1 gateway (app tokens, personal tokens) does not expose TinoPage Builder yet. See Getting started with TinoPage Builder.
Authentication
Send the token in the header Authorization:
Authorization: Bearer <token>
Tokens that can call it: the TinoPage Builder service owner's sign-in token (the tino.vn client area token).
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | int | Required | TinoPage Builder service ID |
site | string | Required | Website ID (UUID, `id` in the website list) |
hostname | string | Required | Custom domain in lower case (`hostname` in the domain list) |
Query
| Name | Type | Required | Description |
|---|---|---|---|
idempotency_key | string | Optional | 8–64 characters `A-Za-z0-9._:-`: resending the same key and content returns the earlier result instead of running again |
Response
Sample built from the TinoPage Builder API (Tino relays the answer as is inside data); values are examples.
Error codes
| Error code | Description |
|---|---|
404 · SERVICE_NOT_FOUND, invalid method | The service does not belong to the signed-in account, or is not TinoPage Builder. |
400 · INVALID_REQUEST | An ID, domain, query or body has the wrong shape; details.field names the field. |
403 · ACCOUNT_SUSPENDED | The service is suspended: writes are blocked, GET still works. |
404 · RESOURCE_NOT_FOUND | The website or domain is not in the account. |
409 · LIMIT_EXCEEDED | A limit of the purchased service is used up; details.key names the limit. |
422 · VALIDATION_FAILED | Invalid data; details lists the fields. |
502, 503 · NETWORK_ERROR, NOT_CONFIGURED… | The connection between Tino and TinoPage Builder is interrupted: a Tino-side error, not a token problem. Retry later. |
Errors look like {"error": ["<CODE>"], "message", "details", "request_id"}; every code is in Getting started with TinoPage Builder.