Sidebar

Update Domain API

PUT /domains/:name

Updates an existing authoritative domain.

Request Body (application/json)

An object containing the fields to update for the domain.

Example

{
  "refresh_interval": 3600,
  "retry_interval": 600,
  "expire_interval": 604800,
  "minimum_ttl": 300,
  "dnssec_enabled": true
}

Authentication

This endpoint requires authentication via Bearer token or API key in query string.


Example Request

curl -X PUT "http://localhost:3000/domains/example.com.json" \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <your-access-token>' \
  -d '{
    "refresh_interval": 3600,
    "retry_interval": 600,
    "expire_interval": 604800,
    "minimum_ttl": 300,
    "dnssec_enabled": true
  }'

Response (200 OK)

Returns the updated domain object.

{
  "name": "example.com",
  "delegated": false,
  "created_at": "1970-01-01T00:00:00.000Z",
  "updated_at": "1970-01-01T00:00:00.000Z",
  "serial_number": 2025043002,
  "refresh_interval": 3600,
  "retry_interval": 600,
  "expire_interval": 604800,
  "minimum_ttl": 300,
  "dnssec_enabled": true
}

Response Schema

Field Type Description
name string Domain name
delegated boolean Whether the domain is delegated
created_at date-time When the domain was created
updated_at date-time When the domain was last updated
serial_number integer SOA serial number
refresh_interval integer SOA refresh value (seconds)
retry_interval integer SOA retry value (seconds)
expire_interval integer SOA expire value (seconds)
minimum_ttl integer SOA minimum TTL (seconds)
dnssec_enabled boolean Whether DNSSEC is enabled

Our use of cookies
We use a session cookie to maintain your login state when you create an account with us. This cookie is essential for the operation of our website and is used solely for authentication purposes. For more information, please read our privacy policy.