/v1/domain/@id/regManage private nameservers
Register, modify or delete private nameservers (glue records) of the domain; choose the operation with action:
registerNameServer: register a new glue record (needsnameserver,ip)modifyNameServer: change the IP of a glue record (needsnameserver,oldip,newip)deleteNameServer: delete a glue record (needsnameserver)
Call it through the gateway https://api.tino.vn/v1 with a token that has the domains:write scope; see Calling the Tino API.
Authentication
Send the token in the header Authorization:
Authorization: Bearer <token>
Tokens that can call it: app tokens (tinoat_, Sign in with Tino) or personal API tokens (tinopat_).
Scopes
domains:writeDomain management
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | Required | Domain ID |
Body (JSON)
| Name | Type | Required | Description |
|---|---|---|---|
action | string | Optional | Operation: registerNameServer, modifyNameServer, deleteNameServer |
nameserver | string | Optional | Full nameserver hostname |
ip | string | Optional | IP address for the nameserver – required for registerNameServer |
oldip | string | Optional | Current IP address – required for modifyNameServer |
newip | string | Optional | New IP address – required for modifyNameServer |
Response
The route's JSON answer, in the same shape as UserAPI returns it (Personal data). Live sample from a test account with personal data masked; long arrays and strings are trimmed (… N more item(s), … N more line(s)).
Error codes
| Error code | Description |
|---|---|
401 · invalid_token | The token is wrong, expired or revoked. |
403 · insufficient_scope | The token lacks the domains:write scope. |
403 · ip_not_allowed | A personal API token called from an IP outside its allow-list. |
Business errors of a route usually come as HTTP 200 with {"error": ["<code>"]}; see common error codes.